Daymark

Standard names for the things you point at — read by humans and AI alike.

항로표지에는 daymark가 붙습니다. 표준 모양(사각·삼각)과 표준 색으로, 낮에도 저것이 무엇인지 한눈에 알아보게 하는 표시입니다. 밤에는 불빛으로 식별하지만, 낮에는 이 표시가 그 일을 합니다.

Daymark는 소프트웨어 개발 용어에 그 표시를 답니다. "말풍선 같은 거" 라고 부르던 것에 툴팁(tooltip) 이라는 표준 명칭을 달아, 사람과 AI 에이전트가 같은 어휘로 대화하게 합니다.

왜 필요한가

"그 창 있잖아, 눌렀을 때 뜨는 거" — 개발과 디자인 사이에서 하루에도 몇 번씩 오가는 말입니다. 표준 명칭이 분명히 있는데도 모르면 매번 손짓으로 돌아갑니다.

AI 에이전트와 일할 때 이 비용은 더 커집니다. 정확한 용어는 한 번에 통하고, 애매한 말은 몇 번을 되묻게 만듭니다.

Daymark는 그 용어들을 모아 무엇이라 부르는지, 무엇과 헷갈리는지, 실제로 어떻게 생겼는지를 함께 보여줍니다.

이 저장소가 담는 것

구역	내용
terms/	용어 항목 — 표준 명칭·별칭·정의·구분·예제
web/	로컬 뷰어 — 목록·검색·라이브 예제

각 용어는 마크다운 파일 하나이고, 예제는 같은 폴더의 React 컴포넌트입니다. 사람은 뷰어로 보고, AI 에이전트는 파일을 직접 읽습니다.

용어 항목의 모습

---
name: tooltip
korean: 툴팁
aliases: [말풍선, 툴팁창, 도움말 풍선]
category: ui/overlay
confused_with: [popover, helper-text, toast]
---

aliases는 사람들이 실제로 부르는 말을 담습니다. "말풍선"으로 찾아도 툴팁에 닿게 하기 위해서입니다. confused_with는 경계가 애매한 이웃을 가리킵니다. 툴팁과 팝오버의 차이를 아는 것이 사전의 실질적인 값어치입니다.

원칙

• 표준 명칭을 따른다 — 우리가 새 이름을 짓지 않습니다. 업계에서 쓰이는 말을 정리합니다
• 정의는 직접 쓴다 — 다른 문서의 문장을 옮기지 않고, 출처는 참고 링크로 답니다
• 보여줄 수 있으면 보여준다 — 툴팁과 팝오버의 차이는 글보다 그림이 빠릅니다

상태

초기 구축 중입니다. 용어가 채워지는 대로 이 README의 목차가 갱신됩니다.

현재는 UI 컴포넌트·패턴부터 정리하고 있으며, 인프라·배포 용어로 넓혀갈 예정입니다.

기여 창구(가이드·CLA)는 아직 준비 중입니다. 준비되면 이 자리에 안내하겠습니다.

라이선스

코드와 콘텐츠의 라이선스가 다릅니다.

대상	라이선스
코드 (web/, 도구)	MIT
콘텐츠 (terms/의 정의·예제)	CC BY-SA 4.0

콘텐츠를 가져다 쓰실 때는 출처를 밝히고 같은 조건으로 공유해 주세요. 다른 조건이 필요하시면 별도 라이선스를 문의해 주시기 바랍니다.

---

_{Part of Followingseas}