한 사이트 안에 공개 글, 기술 문서, 프로젝트 디렉터리를 모두 넣으려 하면 가장 먼저 생기는 유혹은 “어차피 전부 글이니 같은 모델로 다루자”는 생각이다. 하지만 CTRL의 초기 기획을 정리하면서 가장 먼저 확인한 것은, 이 단순화가 오히려 장기 운영을 어렵게 만든다는 점이었다.
CTRL에서 Docs를 Journal과 분리하려는 이유는 디자인 취향 때문이 아니다. 두 시스템이 다루는 시간감각, 읽기 방식, 수정 주기, 검증 기준이 다르기 때문이다. 같은 웹사이트 안에 있더라도 서로 다른 표면으로 운영해야만 아카이브가 제대로 축적된다.
Journal과 Docs는 같은 “글”이 아니다
Journal은 빠르게 발행되는 공개 신호에 가깝다. 모임 기록, 행사 공지, 짧은 회고, 발표 요약처럼 지금 무슨 일이 일어나고 있는지를 전달하는 데 강하다. 독자는 카드 목록에서 최근 글을 훑고, 제목과 요약을 보고, 맥락을 따라가며 읽는다.
반면 Docs는 오래 참조될 문서를 위한 시스템이다. 비교 분석, 검증 결과, 파이프라인 정리, 용어집, 체크리스트처럼 다시 찾아와 읽을 가능성이 높은 정보가 이곳에 쌓인다. 여기서는 시간 순서보다 문서 구조와 탐색성이 더 중요하다.
즉 Journal은 흐름을 보여주고, Docs는 기준을 남긴다. 이 둘을 같은 방식으로 눌러 담으면, 저널은 지나치게 무거워지고 문서는 지나치게 휘발된다.
읽기 경험이 다르기 때문에 정보 구조도 달라져야 한다
기획 문서에서 반복해서 나온 결론은, Docs에는 블로그와 다른 읽기 경험이 필요하다는 점이었다.
Docs에 필요한 것은 대체로 아래와 같다.
- 섹션 구조와 사이드바
- 목차와 문서 간 탐색
- 마지막 수정일과 관련 문서 연결
- 반복 참조를 전제로 한 제목 체계
- 같은 주제를 점진적으로 보강할 수 있는 문서 구조
Journal에는 오히려 다른 장점이 중요하다.
- 최근성 중심의 카드 목록
- 빠른 발행과 수정
- 이벤트, 회고, 공지, 에디토리얼 글의 유연한 게시
- 메인페이지에서 최신 흐름을 보여주는 역할
둘 다 Markdown이나 MDX로 쓸 수는 있지만, 어떤 화면에서 어떻게 읽히는지가 다르기 때문에 결국 다른 시스템으로 다뤄야 한다.
운영 속도와 검증 방식도 다르다
Journal은 CMS-first에 가깝다. 운영자나 편집자가 비교적 빠르게 쓰고, 발행하고, 정정할 수 있어야 한다. 행사 공지나 회고처럼 시점이 중요한 글은 이 속도가 중요하다.
Docs는 그보다 더 보수적인 관리가 필요하다. 문서가 한 번 올라가면 나중에 다른 문서의 기준이 되거나, 프로젝트 설명의 근거가 되거나, 반복적으로 링크되는 레퍼런스가 되기 때문이다. 그래서 Docs는 다음 같은 조건을 더 강하게 요구한다.
- 문서 경계가 명확할 것
- 공개 범위와 검증 상태를 관리할 수 있을 것
- 관련 프로젝트나 저널 글과 상호 참조될 것
- 시간이 지나도 다시 다듬을 수 있는 장기 문서일 것
이 차이를 무시하고 Docs를 단순한 블로그 카테고리로 넣어버리면, 결국 문서가 쌓이는 대신 게시물이 늘어나는 구조가 된다. CTRL이 지향하는 것은 게시물 수를 늘리는 사이트가 아니라, 한국어 기반의 장기 아카이브를 만드는 일이다.
메인 사이트의 역할도 달라진다
CTRL 메인 사이트는 모든 것을 한데 합쳐놓은 거대한 본체가 아니라, Journal, Docs, Projects를 연결하는 허브로 설계하고 있다. 이때 Home에서는 최신 Journal이 살아 있어야 하고, Docs는 별도의 진입점으로 분명해야 하며, Projects는 GitHub 작업의 입구 역할을 해야 한다.
만약 Docs까지 Journal 카드 안에 흡수하면 메인페이지는 겉보기에 풍성해질 수 있어도, 사용자는 아래 같은 혼란을 겪게 된다.
- 지금 보고 있는 글이 소식인지 기준 문서인지 구분하기 어렵다.
- 어떤 글은 시의성이 중요하고 어떤 글은 참조성이 중요한데, 둘이 같은 카드 체계에 섞인다.
- 문서의 최신성, 검증 상태, 관련 프로젝트 맥락이 잘 드러나지 않는다.
결국 Home을 살리는 가장 좋은 방법은 모든 글을 한 리스트에 밀어 넣는 것이 아니라, 각 시스템이 자기 성격대로 읽히게 만드는 것이다.
분리하되 끊지는 않는다
중요한 건 Journal과 Docs를 완전히 단절하는 것이 아니다. 오히려 두 시스템은 서로 적극적으로 연결되어야 한다.
- Journal 글은 관련 Docs를 소개하고 맥락을 붙인다.
- Docs는 관련 Journal 글을 통해 어떤 논의와 공개 흐름에서 나왔는지 보여준다.
- 어떤 주제가 처음에는 회고나 발표 요약으로 Journal에 실리더라도, 반복 참조 가치가 생기면 Docs로 재정리할 수 있다.
이 원칙 덕분에 CTRL은 “지금의 흐름”과 “오래 남길 기준”을 동시에 다룰 수 있다. 저널은 커뮤니티의 현재를 보여주고, 문서는 그 현재에서 추출된 지식을 오래 붙잡아 둔다.
지금 단계에서의 결론
초기 기획 문서들을 다시 읽어보면, CTRL이 처음부터 단순한 블로그를 만들려 한 적은 없다는 점이 분명하다. 목표는 여러 DCC와 엔진, 다양한 실무 맥락에서 나온 지식을 한국어로 기록하고 축적하는 공개 허브를 만드는 것이다. 그 목표를 실무적으로 성립시키려면 Docs는 Journal의 하위 카테고리가 아니라 독립적인 문서 시스템이어야 한다.
이 메모는 앞으로 디자인이나 구현 세부가 바뀌더라도 유지해야 할 기준에 가깝다. 글을 어디에 둘 것인가는 단순한 편집 선택이 아니라, CTRL이 무엇을 오래 남기려 하는가에 대한 운영 결정이기 때문이다.