Codaro가 실제로 만들고 있는 것

Codaro는 코드 실행, 학습 카드, 개인 자동화가 하나의 문서 모델을 공유하는 실행형 스튜디오를 만들고 있다.

로컬 에디터는 제품의 한 부분이다. 공개 사이트는 그 런타임을 왜 이렇게 설계했는지, 어떤 사용 흐름을 기준으로 삼는지 설명하는 표면이다.

세 가지 층

1. 코드, 글, 워크플로우 블록을 함께 담는 문서 모델
2. 로컬과 브라우저 지향 환경에서 실행되는 런타임
3. 가이드, 변경 기록, 제품 판단을 공개하는 문서 기반 지식 표면

공개 사이트를 따로 두는 이유

에디터는 실행과 상호작용에 집중해야 한다.

공개 사이트는 다른 조건을 가진다.

• 정적 배포
• 검색 가능한 문서와 글
• 안정적인 GitHub Pages 배포
• 제품 판단을 남기는 공개 기록

그래서 Codaro는 공개 사이트인 landing/과 로컬 제품 표면인 editor/를 분리한다.

공개 문서는 제품의 일부다

공개 사이트는 부가 자료가 아니다.

다음 내용을 사용자가 확인하는 표면이다.

• 설치 안내
• 핵심 개념 설명
• 기준 문서
• 런타임 결정의 배경을 설명하는 글

글은 저장소 가까이에 둔다

Codaro는 공개 문서, 운영 노트, 블로그 글을 루트 docs/ 아래에 둔다. React 공개 사이트는 빌드 시점에 이 원문을 직접 읽는다.

이 방식은 글을 코드베이스 가까이에 두면서도 정적 사이트로 배포할 수 있게 한다.