코드로서의 문서: 완전한 CI/CD 워크플로우 (Git부터 프로덕션까지)

이 텍스트는 실제 환경 설정과 모범 사례를 강조하며, 코드형 문서(docs-as-code) 파이프라인을 구현하기 위한 실용적인 가이드를 제공합니다. 코드와 동일한 저장소에 문서를 저장하고, 사용자 작업별로 문서를 구성하며, 설정 파일을 루트 레벨에 배치할 것을 제안합니다. 작성 워크플로우는 Git 브랜칭, "왜"에 대한 자세한 설명을 포함하는 PR 템플릿, 맞춤법, 링크, 스타일을 위한 자동화된 품질 검사를 포함합니다. 또한, 자동화된 검사를 통과한 후에는 인간 검토자가 내용의 정확성과 명확성에 집중해야 한다고 설명합니다. 마지막으로, 자동 배포를 제안하고, 초기 단계에서 모든 검사를 실행하고, 모든 경고에 대해 PR을 차단하며, 트리거 없이 별도의 문서 저장소를 사용하는 것과 같은 일반적인 실수를 설명합니다.