문서의 일관성을 유지하기 위해 Technical Writing 팀은 다음 단어 선택을 권장합니다. --> --> .gitlab-ci.yml file # the .gitlab-ci.yml file 에는 백틱과 소문자를 사용합니다. 가능하면 전체 표현인 the .gitlab-ci.yml file 을 사용합니다. 사용자가 CI/CD 구성 파일에 다른 이름을 지정할 수 있더라도, 대부분의 경우 the .gitlab-ci.yml file 을 대신 사용합니다. & (ampersand) # 라틴어 약어를 사용하지 않습니다. & 를 사용하는 UI 요소를 문서화하는 경우가 아니라면 대신 and 를 사용합니다. @mention # @mention 은 가급적 사용하지 않습니다. 대신 mention 이라고 쓰고, 멘션 항목 으로 링크하는 것을 고려합니다. 백틱은 사용하지 않습니다. 2FA, TFA, two-factor authentication # 처음 사용할 때와 항목 제목에서는 two-factor authentication 을 문장 표기 형식으로 풀어 쓰고, 이후에는 2FA 를 사용합니다. 문장의 첫 단어인 경우 factor 와 authentication 은 대문자로 쓰지 않습니다. TFA 는 사용하지 않습니다. 예를 들면 다음과 같습니다. Two-factor authentication (2FA) helps secure your account. Set up 2FA when you first sign in. ability, able # ability 와 able 은 의미가 모호할 수 있으므로 가급적 사용하지 않습니다. 이 단어들의 용법은 allow와 enable 과 비슷합니다. 사용자의 능력이나 제품의 기능을 말하는 대신 직접적이고 구체적으로 서술합니다. 다만 보안을 다루는 경우나, UI에서 누군가 작업을 완료하지 못하도록 막는 경우에는 이 단어를 사용할 수 있습니다. ability 나 able 을 permissions 또는 roles 와 혼동하지 않습니다. 권장 표현: You cannot change this setting. To change this setting, you must have the Developer, Maintainer, or Owner role. Confirm you can sign in. The external load balancer cannot connect. Option to delete branches introduced in GitLab 17.1. 피할 표현: You are not able to change this setting. You must have the ability to change this setting. Verify you are able to sign in. The external load balancer will not be able to connect. Ability to delete branches introduced in GitLab 17.1. above # 문서 페이지의 예시나 표