google/eng-practices

Google's Engineering Practices documentation

23,308
GitHub 스타
2,278
포크
언어
NOASSERTION
라이선스
2024.09.19
최근 푸시
2026.05.27
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
코드 리뷰 문화를 개선하려는 팀이나 조직에 적극 추천합니다. 특히 코드 리뷰어와 개발자 모두에게 실용적인 지침을 제공하므로, 리뷰 프로세스를 표준화하고 품질을 높이는 데 도움이 됩니다.

강점

  • Google의 실제 엔지니어링 경험을 바탕으로 한 모범 사례 문서로, 신뢰성이 높습니다.
  • 코드 리뷰어와 변경 작성자 모두를 위한 구체적인 가이드를 제공하여 실무에 바로 적용할 수 있습니다.
  • CC-By 3.0 라이선스로 공개되어 자유롭게 공유하고 활용할 수 있습니다.

약점

  • 저장소가 보관(archived) 상태여서 더 이상 업데이트되지 않을 가능성이 있습니다.
  • 문서가 Google 내부 용어(CL, LGTM 등)를 사용하므로 외부 개발자에게는 익숙하지 않을 수 있습니다.
  • 현재 코드 리뷰 가이드라인만 포함되어 있으며, 다른 엔지니어링 실천 방법 문서는 아직 추가되지 않았습니다.

주의사항

  • 저장소가 보관(archived) 상태이므로 새로운 변경이나 업데이트가 이루어지지 않습니다.
  • 문서는 Google의 관행을 반영하므로 모든 조직에 완전히 맞지 않을 수 있습니다.
  • 용어 설명을 먼저 읽지 않으면 CL, LGTM 등의 용어가 혼동될 수 있습니다.

시작 가이드

  • 저장소를 클론하거나 문서를 다운로드하여 팀 내에서 공유합니다.
  • 코드 리뷰어 가이드와 변경 작성자 가이드를 읽고 팀의 리뷰 프로세스에 적용할 부분을 식별합니다.
  • 팀 회의에서 문서의 주요 내용을 논의하고, 필요에 따라 내부 가이드라인을 업데이트합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Google 엔지니어링 실천 방법 문서

Google은 모든 언어와 모든 프로젝트에 적용되는 일반화된 엔지니어링 실천 방법을 많이 보유하고 있습니다. 이 문서들은 시간이 지남에 따라 개발한 다양한 모범 사례에 대한 우리의 집단적 경험을 나타냅니다. 오픈 소스 프로젝트나 다른 조직이 이 지식을 활용할 수 있을 가능성이 있으므로, 가능할 때 공개적으로 제공하기 위해 노력하고 있습니다.

현재 이 저장소에는 다음 문서가 포함되어 있습니다:

  • Google의 코드 리뷰 가이드라인 - 실제로는 두 개의 별도 문서 세트입니다:
  • 코드 리뷰어 가이드
  • 변경 작성자 가이드

용어

일부 문서에는 Google 내부 용어가 사용되며, 외부 독자를 위해 여기서 설명합니다:

  • CL: "changelist"의 약자로, 버전 관리에 제출되었거나 코드 리뷰 중인 하나의 독립적인 변경을 의미합니다. 다른 조직에서는 이를 "change", "patch", 또는 "pull-request"라고 부르기도 합니다.
  • LGTM: "Looks Good to Me"의 약자로, 코드 리뷰어가 CL을 승인할 때 사용하는 표현입니다.

라이선스

이 프로젝트의 문서는 CC-By 3.0 라이선스에 따라 라이선스가 부여되며, 문서 공유를 장려합니다. 자세한 내용은 <https://creativecommons.org/licenses/by/3.0/>을 참조하세요.

<a rel="license" href="https://creativecommons.org/licenses/by/3.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/3.0/88x31.png" /></a>

원본 저장소: google/eng-practices

라이선스: NOASSERTION

게재 제외를 원하시면 삭제 요청을 보내주세요.