[OSSCA] kubernetes/website : Hugo 템플릿 개선 제안

쿠버네티스 공식 웹사이트는 Hugo 기반으로 빌드된다. 문서 내 예제 코드를 삽입할 때 사용하는 code_sample.html shortcode에 개선 사항을 제시하였다. 
 
 
 

• 문제 상황
  • 한글화가 필요 없는 YAML, 이미지 예제 파일들이 ko 디렉토리에 없으면 빌드 에러 발생.
  • 사실 이런 파일은 en 디렉토리에만 있어도 충분하지만, fallback 로직이 없어 중복 관리해야 했다.
• 내 제안
  • with else 구문과 readFile 로직을 활용하여 ko에 없으면 자동으로 en 파일을 읽어오는 fallback 로직을 추가하는 PR/이슈를 올렸다.
  • 이를 통해 불필요한 파일 복제를 줄이고, 유지보수 비용을 낮출 수 있을 것이라 생각하였다 

이 과정에서 Hugo의 safeURL, errorf 같은 함수 사용법을 파악하고, 단순 문서 번역을 넘어 빌드 로직에도 직접 기여하는 경험을 했다.
 
 
Issue / Discussion 참여

• Feature Request 작성
• “code_sample.html에 fallback 로직을 추가하자”라는 이슈를 정식 템플릿(Feature Request)으로 작성했다. 단순히 개인 의견이 아니라, 프로젝트 컨벤션에 맞게 문제 정의 → 필요성 설명 → 개선 효과 정리 형태로 기록했다.
• Discussion에 의견 제시
• 다른 기여자들의 의견을 듣고, 내가 생각한 방법이 유일한 답이 아님을 공유하면서 대안 제시를 요청하는 식으로 소통했다.

 
기여를 통해 얻은 것

1. 글로벌 협업 경험
2. 영어로 이슈를 작성하고 리뷰를 주고받는 과정을 통해, 단순 기술 스택을 넘어 글로벌 오픈소스 협업 역량을 키웠다.
3. 소프트웨어 품질에 대한 관점 확장번역, 빌드, 코드 스타일 등 작은 부분도 결국 사용자의 경험 품질로 이어진다는 걸 체감했다.