프로젝트 소개

helm-www는 Helm 패키지 관리자 프로젝트의 웹사이트인 helm.sh의 저장소입니다. Helm 문서를 편집하거나, 웹사이트 문제를 보고하거나, 블로그 글을 게시하거나, 프로젝트 정보를 업데이트하려는 사람을 대상으로 합니다. 이 사이트는 Docusaurus로 정적 웹사이트로 빌드됩니다. 기여자는 yarn으로 의존성을 설치하고 yarn start로 사이트를 로컬에서 실행할 수 있습니다. main 브랜치에 병합된 변경 사항은 Netlify에 자동으로 배포되며, 배포 로그와 상태를 확인할 수 있습니다. 이 저장소는 여러 문서 버전을 관리합니다. Helm v4 문서는 최상위 docs 디렉터리에 있고, Helm v3 문서는 versioned-docs/version-3에 있으며, 이전 Helm v2 문서는 메인 Helm 저장소의 dev-v2 브랜치에 남아 있습니다. 버전 레이블, URL 경로, 사이드바, 최신 안정 버전, 사전 릴리스 문서는 docusaurus.config.js, versioned_docs, versioned_sidebars, versions.json을 통해 구성됩니다. 문서 워크플로는 /docs/next 아래의 사전 릴리스 문서, 자동 미출시 버전 배너, 사전 릴리스 문서의 일반 공개 버전 승격, 새로운 메이저 문서 버전 생성을 지원합니다. 커뮤니티 문서는 helm/community 저장소에서 가져옵니다. yarn download-remote-community 명령은 해당 콘텐츠를 가져와 변환하고, yarn clear-remote-community는 가져온 파일을 제거합니다. 가져오기 구성은 docusaurus.config.js에 정의되어 있습니다. Helm CLI 명령 참조 문서는 scripts/regenerate-cli-docs.mjs로 다시 생성할 수 있습니다. 이 스크립트는 지정된 Helm 버전을 다운로드하고, 선택한 대상 디렉터리에 문서를 생성하며, frontmatter 정리 및 링크 변환과 같은 후처리를 수행합니다. 블로그 글은 blog 디렉터리에 Markdown 파일로 추가되며 title, slug, authors, date에 대한 YAML 메타데이터를 포함합니다. 새 작성자는 blog/authors.yml에 추가되고, 블로그 이미지는 blog/images에 저장되며, 잘림 표시자가 블로그 인덱스 요약을 제어합니다. 블로그 풀 리퀘스트는 Helm 핵심 메인테이너의 승인이 필요합니다. 기여에는 서명된 커밋과 메인테이너 승인이 필요합니다. 이 저장소는 또한 문서 스타일 가이드, 가져온 커뮤니티 문서에 대한 아키텍처 노트, 행동 강령, 번역을 위한 문서 현지화 지원을 제공합니다.