공지 – AWS 설명서, GitHub 저장소 제공 중지

약 5년 전 저는 AWS 설명서를 오픈 소스로서 GitHub 제공을 발표했습니다. 오랜 실험 끝에 6월 5일 주부터 기존 문서를 리포지토리 업데이트를 중지하고, 앞으로 AWS 설명서 및 웹 사이트를 직접 개선하는 데 모든 리소스를 투자할 예정입니다.

AWS 설명서 대부분의 주요 소스는 GitHub 리포지토리와 수동으로 동기화해야 했던 내부 시스템에 있습니다. 문서화 팀이 최선의 노력을 기울였음에도 공개 리포지토리와 내부 리포지토리의 동기화 유지는 몇 가지의 수동 단계와 몇 가지의 병렬 편집을 거치면 매우 어렵고 시간이 많이 걸리는 것으로 입증되었습니다. 매년 262개의 개별 리포지토리와 수천 개의 기능 출시로 인해 오버헤드는 매우 높았고 실제로 문서 품질을 보다 직접적으로 개선하는 방식으로 사용할 수 있는 귀중한 시간이 소비되었습니다.

저희는 개방성 및 협업을 통해 고객에 대한 가치를 높이고자 했으나 고객 피드백을 통해 반드시 그렇지마는 않다는 점을 알게 되었습니다. 많은 옵션을 신중하게 고려한 후 리포지토리를 사용 중지하고 콘텐츠를 개선하는 데 모든 리소스를 투자하기로 결정했습니다.

코드 샘플, 샘플 앱, CloudFormation 템플릿, 구성 파일 및 기타 추가 리소스를 포함하는 리포지토리는 기본 소스이며 참여도가 높기 때문에 그대로 유지됩니다.

또한 문서 개선을 지원하기 위해 사용자의 피드백에 더 많은 리소스를 집중하고 있습니다.

저희는 매주 좋아요 및 싫어요 메트릭을 관찰하고 이 메트릭을 문서에서 개선해야 할 지점을 가리키는 최상위 수준의 포인터로 사용합니다. 수신되는 피드백은 페이지 담당자 또는 담당 팀에 직접 라우팅되는 티켓을 생성합니다. 저는 두 피드백 메커니즘을 자주 사용하기를 강력히 권장합니다.

— Jeff;