용어집

용어집

개요

이 섹션은 appendix의 일부가 아니다. overview, transition, harness, enforcement를 가로질러 같은 단어를 같은 뜻으로 읽게 만드는 언어 레이어다.^glossary

즉 이 섹션의 역할은 부가 설명이 아니라, 문서 전체에서 반복되는 핵심 용어의 해석 기준을 한 곳에 고정하는 것이다.

이 저장소는 서로 다른 배경을 가진 독자를 함께 상대한다.

이때 같은 단어를 서로 다르게 읽기 시작하면 문서의 논지보다 용어 해석 차이가 먼저 충돌한다.

특히 다음 단어들은 일반 상식어가 아니라 이 프로젝트의 구조를 이루는 시스템 용어다.

그래서 이 용어들은 각 문서 안에서 반복 정의하지 않고, 여기서 먼저 기준을 고정한다.

glossary는 본론을 대신하는 섹션이 아니다. 구조 문서에서 반복해서 호출되는 용어의 기준을 한곳에 모아 둔 참조층이다.

따라서 이 섹션의 역할은 설명을 늘리는 것이 아니라, 본문에서 이미 쓰이고 있는 단어의 의미를 흔들리지 않게 고정하는 데 있다.

중심은 이 프로젝트가 직접 정의하는 용어다. 외부 기술 용어는 반복 등장하거나 해석 충돌이 생길 때만 최소한으로 추가한다.

좋은 glossary 항목은 뜻만 적지 않는다. 각 항목은 최소한 다음 네 가지를 포함해야 한다.

가독성을 위해 같은 문서에서 같은 용어를 반복 링크하지 않는다. 첫 등장만 glossary로 연결하고, 이후는 일반 텍스트로 둔다.

glossary는 부록이 아니라 문서 전체가 같은 언어를 쓰게 만드는 기준층이다.

이 섹션의 목적은 단어를 번역하는 것이 아니라, 구조 문서가 같은 개념 체계 위에서 읽히게 만드는 것이다.