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:01

8장 포괄적 언어(Inclusive Language)

모든 코드에서, 네이밍 및 주석을 포함하여, 다른 프로그래머가 불쾌하거나 모욕적으로 느낄 수 있는 용어 사용을 피하고 포괄적 언어를 사용해야 한다. 예를 들어, "master"와 "slave", "blacklist"와 "whitelist", "redline" 등의 용어는 겉보기에는 중립적인 의미를 가질 수 있지만, 특정 집단에게는 불쾌하게 다가올 수 있으므로 사용하지 않는다.

또한, 특정인을 지칭하지 않는 한 성 중립적인 언어를 사용해야 한다. 예를 들어, 성별이 지정되지 않은 사람을 지칭할 때는 "they"/"them"/"their"와 같은 단수형을 사용하며, 소프트웨어, 컴퓨터, 기타 사람이 아닌 것을 지칭할 때는 "it"/"its"를 사용한다.

권장 예시

  • 사람을 지칭할 때
    • "the developer can update their code"와 같이 성 중립적인 대명사 사용
  • 명칭 변경
    • "primary"/"secondary" 또는 "allowlist"/"denylist"와 같은 대체 용어 사용

주의사항

  • 포괄적 언어는 코드의 접근성과 가독성을 높이며, 더욱 다양한 배경을 가진 개발자가 코드를 이해하고 유지 관리하는 데 도움을 준다.
  • 용어 변경은 기존의 용어를 새로운 용어로 바꾸는 데에 약간의 노력이 필요할 수 있지만, 이는 코드를 더욱 포용적이고 현대적인 방식으로 유지하기 위한 중요한 단계다.

참조URL

https://google.github.io/styleguide/cppguide.html

728x90