[hellices]

수정 내용

서비스 메뉴의 첫 번째 문서가 서비스 제목으로 표시되어 하위 목록에서 빠지는 문제를 수정합니다. #59 병합 후 AKS 트러블슈팅 목록은 3개인데 왼쪽 메뉴에는 2개만 보인다는 제보로 확인했습니다.

원인

문서 bundle을 메뉴의 leaf로 펼친 뒤에도 각 문서는 index.md입니다. Material의 navigation.indexes가 서비스의 첫 번째 문서를 해당 서비스의 섹션 인덱스로 선택해, 서비스 이름에 첫 글의 URL을 붙이고 그 글을 하위 메뉴에서는 생략했습니다.

해결

• <collection>/<service>/index.md를 빌드 시 자동 생성합니다.
• 서비스 제목은 이 서비스별 목록으로 연결하고, 첫 글을 포함한 모든 문서를 별도 하위 메뉴로 유지합니다.
• 기존 서비스 페이지 렌더러를 재사용하며 메뉴 설정이나 수동 문서 목록을 추가하지 않습니다.
• 실제 기술 문서의 내용·메타데이터·기존 URL과 디자인은 변경하지 않습니다.
• 기여 안내에 서비스 목록 페이지의 자동 생성 원칙을 설명했습니다.

검증

• 첫 글의 URL에 서비스 이름이 붙는 현상을 회귀 테스트로 재현한 뒤 수정
• 문서 1개·3개 서비스, 첫 글 열람 상태, 서비스 제목과 각 문서의 제목/URL을 실제 빌드 HTML로 확인
• 문서 유형·주 서비스별 목록과 다중 서비스 메타데이터의 기존 집계 의미 유지
• 전체 문서 테스트: 76 passed
• 메타데이터·출처·링크·공개 안전성·strict 빌드·검색 검증 통과
• 생성된 메뉴의 문서 62개 제목/URL과 서비스별 목록 21개 연결 대조
• 로컬 브라우저에서 AKS의 세 글, 문서 1개인 AI Search/Redis, 모바일 메뉴와 현재 문서 강조 확인
• git diff --check

Microsoft/Azure 제품 동작에 대한 기술 주장은 변경하지 않았습니다. 생성된 site/과 별도 작업 폴더는 포함하지 않습니다.