anothel의 지식 창고
Google C++ Style Guide(2024) - 8장 포괄적 언어(Inclusive Language) 본문
기술 노트/Google Code Style Guide
Google C++ Style Guide(2024) - 8장 포괄적 언어(Inclusive Language)
anothel 2024. 11. 11. 19:018장 포괄적 언어(Inclusive Language)
모든 코드에서, 네이밍 및 주석을 포함하여, 다른 프로그래머가 불쾌하거나 모욕적으로 느낄 수 있는 용어 사용을 피하고 포괄적 언어를 사용해야 한다. 예를 들어, "master"와 "slave", "blacklist"와 "whitelist", "redline" 등의 용어는 겉보기에는 중립적인 의미를 가질 수 있지만, 특정 집단에게는 불쾌하게 다가올 수 있으므로 사용하지 않는다.
또한, 특정인을 지칭하지 않는 한 성 중립적인 언어를 사용해야 한다. 예를 들어, 성별이 지정되지 않은 사람을 지칭할 때는 "they"/"them"/"their"와 같은 단수형을 사용하며, 소프트웨어, 컴퓨터, 기타 사람이 아닌 것을 지칭할 때는 "it"/"its"를 사용한다.
권장 예시
- 사람을 지칭할 때
- "the developer can update their code"와 같이 성 중립적인 대명사 사용
- 명칭 변경
- "primary"/"secondary" 또는 "allowlist"/"denylist"와 같은 대체 용어 사용
주의사항
- 포괄적 언어는 코드의 접근성과 가독성을 높이며, 더욱 다양한 배경을 가진 개발자가 코드를 이해하고 유지 관리하는 데 도움을 준다.
- 용어 변경은 기존의 용어를 새로운 용어로 바꾸는 데에 약간의 노력이 필요할 수 있지만, 이는 코드를 더욱 포용적이고 현대적인 방식으로 유지하기 위한 중요한 단계다.
참조URL
728x90
'기술 노트 > Google Code Style Guide' 카테고리의 다른 글
Google C++ Style Guide(2024) - 10장 주석(Comments) (0) | 2024.11.13 |
---|---|
Google C++ Style Guide(2024) - 9장 명명 규칙(Naming) (1) | 2024.11.12 |
Google C++ Style Guide(2024) - 7장 기타 C++ 기능(Other C++ Features) (6) | 2024.11.10 |
Google C++ Style Guide(2024) - 6장 Google 특유의 테크닉(Google-Specific Magic) (2) | 2024.11.09 |
Google C++ Style Guide(2024) - 5장 함수 (Functions) (0) | 2024.11.08 |