Etsy의 코드형 문서

Docs-as-code는 개발에서 문서를 통합하여 코드와 동일한 도구 및 절차를 사용합니다. 버전 관리, 평문 마크업 및 자동화에 중점을 두어 문서 관리를 개선합니다. Etsy의 Docsbuilder 도구는 문서 작성 및 유지에 Markdown, Docusaurus 및 GitOps 워크플로우를 사용합니다. Docsbuilder는 Google Cloud Build 및 통합 테스트와 함께 사이트 생성, 검증 및 배포를 자동화합니다. Docsbuilder는 검색 엔진 및 자주 사용되는 사이트에 대한 탐색 구성 요소를 통해 검색 가능성을 향상시킵니다. Etsy는 현재 Docsbuilder 사이트 150개에 6.2k 페이지 이상을 호스팅하고 있습니다. Docs-as-code의 목표는 문서의 품질, 효율성 및 신뢰성을 향상시키는 것입니다. 주요 원칙은 문서를 1급 시민으로 대우하는 것, Git에서 버전 관리, 평문 형식 사용 및 워크플로우 자동화입니다. Docs-as-code는 개발자가 문서를 코딩과 동일한 엄격도로 접근하도록 장려합니다. Etsy는 Docsbuilder 내에서 검색 가능성, 탐색 및 콘텐츠 참여도를 향상시키고 있습니다. Docs-as-code는 문서와 코딩 간의 균형 있는 접근 방식을 장려하여 조직화되고 유지 가능한 문서를 생성합니다.