용어집 – Controlled Systems Engineering

용어집

개요

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

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

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

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

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

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

이 섹션을 처음부터 끝까지 외울 필요는 없다. 대신 다음 방식으로 쓰는 것이 자연스럽다.

즉 glossary는 별도 본론이 아니라, 본론을 흔들리지 않게 읽게 만드는 병렬 레퍼런스다.

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

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

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

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

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