brief.ing.gg

BRIEFING

개인 지식 사이트의 공개 구조

개인 지식 사이트의 공개 구조

Scope

핵심 질문

개인 노트를 공개 지식 사이트로 전환할 때 내부 메모와 공개 문서를 어떻게 분리해야 하는가?

Draft

개인 지식 사이트는 private note를 그대로 노출하기보다 공개 가능한 지식 단위로 다시 편집하는 것이 좋다.

두 종류의 콘텐츠

정의와 개념은 Wiki, 특정 질문과 판단은 Briefing처럼 문서 역할을 구분하면 독자가 무엇을 기대해야 하는지 알기 쉽다.

내부 정보 제거

개인 장비 hostname, 계정, 가족정보, 업무 내부정보처럼 외부 독자에게 필요 없는 맥락은 일반화한다.

메타데이터

문서 type, stage, updated date와 source를 구조화하면 정적 사이트로 export하기 쉽다.

URL

문서 제목이 바뀌어도 link가 깨지지 않도록 stable slug나 redirect 정책을 둔다.

핵심

공개 지식 사이트는 노트를 많이 보여주는 곳보다 개인 경험에서 재사용 가능한 지식을 추출하는 곳으로 설계하는 것이 좋다.