Glossary

Glossary는 특정 도메인, 조직, 제품, 프로젝트에서 사용하는 표준 용어, 약어, 별칭을 정리하는 용어 사전입니다.

Glossary의 목적은 단어 뜻을 나열하는 데 그치지 않습니다. 같은 개념을 여러 사람이 다른 이름으로 부를 때 표준 표현을 정하고, 다른 표현을 alias로 연결해 커뮤니케이션과 검색의 정확도를 높이는 데 있습니다.

역할

Glossary는 다음 역할을 합니다.

검색어를 alias로 확장합니다.
canonical term을 정해 같은 개념의 표기를 일관되게 유지합니다.
관련 문서 경로를 연결해 먼저 읽을 위치를 좁힙니다.
새 문서 작성 시 기존 용어와 충돌하는 표현을 줄입니다.

예를 들어 운영 문서에서 SLO, Service Level Objective, 서비스 수준 목표가 함께 쓰인다면, glossary는 이 표현들을 하나의 개념으로 묶습니다.

canonical: Service Level Objective
aliases:
  - SLO
  - 서비스 수준 목표
definition: 서비스가 목표로 삼는 내부 신뢰성 기준입니다.

이렇게 정리하면 SLO나 서비스 수준 목표로 검색해도 같은 개념에 도달할 수 있고, 새 문서에서는 Service Level Objective라는 표준 표현을 기준으로 삼을 수 있습니다.

구성

Glossary의 한 항목은 보통 다음 요소를 가집니다.

canonical: 표준으로 사용할 이름입니다.
aliases: 같은 개념을 가리키는 다른 표현입니다.
definition: 용어의 의미와 범위를 설명합니다.
references: 먼저 읽을 관련 문서, API, 설계 기록입니다.

이 구조는 태그와 다릅니다. 태그는 문서의 성격을 분류하는 표식이고, glossary는 검색어와 지식 위치를 연결하는 색인입니다.

추가 기준

다음 경우에는 glossary에 추가하는 편이 좋습니다.

한국어와 영어 표현이 함께 쓰이는 개념입니다.
약어와 풀네임이 모두 자주 쓰이는 개념입니다.
조직 용어, 프로젝트명, 기술명이 여러 표현으로 섞이는 경우입니다.
관련 문서가 여러 위치에 흩어져 있어 검색 시작점이 필요한 경우입니다.

다음 경우에는 추가하지 않아도 됩니다.

한 번만 등장하는 임시 표현입니다.
파일명, 제목, 태그만으로 충분히 찾을 수 있는 표현입니다.
아직 canonical term을 정할 만큼 의미가 안정되지 않은 표현입니다.

Ontology와의 차이

Glossary와 ontology는 비슷해 보이지만 목적이 다릅니다.

Glossary는 용어와 alias를 정리해 사람이 같은 개념을 같은 이름으로 찾게 돕습니다. Ontology는 개념 사이의 관계까지 모델링합니다. 예를 들어 Service Level Objective가 Service Level Indicator로 측정되고, Error Budget과 어떤 관계를 갖는지까지 표현한다면 ontology에 가까워집니다.

이 문서에서 다루는 glossary는 ontology가 아닙니다. 개념 간 관계를 정교하게 추론하기보다, 검색 확장과 탐색 시작점 제공에 집중합니다.

Document History

2026-05-25T00:00:00+09:00 - Written by GPT-5.5 Codex
2026-05-25T21:30:00+09:00 - Edited by GPT-5.5 Codex