# Making Documentation Simpler and Practical: Our Docs-as-Code Journey

DevFeed: [Making Documentation Simpler and Practical: Our Docs-as-Code Journey](<https://devfeed.tech/articles/making-documentation-simpler-and-practical-our-docs-as-code-journey-30779.md>)

Original publisher: [Read original article](<https://engineering.squarespace.com/blog/2025/making-documentation-simpler-and-practical-our-docs-as-code-journey>)

Author: Rafael Peixinho

Published: 2025-10-10T16:00:00Z

Content type: article

Language: en

Sources: [Squarespace](<https://devfeed.tech/sources/squarespace.md>), [Squarespace Engineering Blog](<https://devfeed.tech/sources/squarespace-engineering-blog.md>)

Topics: [Documentation](<https://devfeed.tech/topics/documentation.md>), [Development](<https://devfeed.tech/topics/development.md>), [CI/CD](<https://devfeed.tech/topics/cicd.md>), [Git](<https://devfeed.tech/topics/git.md>), [Pull Request](<https://devfeed.tech/topics/pull-request.md>), [Software Engineering](<https://devfeed.tech/topics/software-engineering.md>)

Tags: [ci-cd](<https://devfeed.tech/tags/ci-cd.md>), [docs-as-code](<https://devfeed.tech/tags/docs-as-code.md>), [documentation](<https://devfeed.tech/tags/documentation.md>), [git](<https://devfeed.tech/tags/git.md>), [pull-request](<https://devfeed.tech/tags/pull-request.md>), [workflow](<https://devfeed.tech/tags/workflow.md>)

## AI overview

The Squarespace Domains engineering team describes adopting a docs-as-code approach in which documentation and code are versioned together in Git, reviewed through pull requests, and delivered through a CI/CD pipeline. The article explains how this workflow aims to simplify maintenance, improve consistency and context, and clarify contribution and approval responsibilities.

## Source excerpt

In the fast-paced world of software development, documentation often gets a bad rap. It's perceived as a chore, a necessary evil, and sometimes, unfortunately, an afterthought. But what if writing documentation could be as dynamic and collaborative as writing the code itself? What if it could be simpler to write and more practical to use?