Your repo · Your Cloudflare · Your agent

AI가 문서를 초안 작성합니다.

팀원들이 완성시킵니다.

이미 비용을 지불하고 있는 코딩 에이전트를 여러분의 코드와 문서에 연결하세요. 그러면 docs 브랜치가 열리고, 팀원들은 렌더링된 페이지에서 이를 검토한 후 커밋으로 게시합니다. 이 모든 과정은 여러분의 GitHub와 Cloudflare 내에서 실행됩니다.

또는 이것을 Claude Code에 붙여넣으세요:

Read https://app.docs.dev/auth.md and set up a docs.dev documentation site for this repo. When it is live, give me the claim link.

코드가 배포되는 방식대로 문서가 배포됩니다.

01

기능 배포하기

여러분의 코드는 평소처럼 배포됩니다. 이때 발생하는 문서 부채(docs debt)가 시작되며, 수정 작업도 여기서부터 시작됩니다.

02

에이전트가 문서를 초안 작성합니다

Claude Code에 코드 저장소 옆에 문서 저장소를 추가하세요.

템플릿에는 에이전트 지침(agent instructions)과 스킬(skills)이 포함되어 있어, 처음부터 '페이지 추가', '내비게이션 수정', 또는 '검토용 초안 작성' 같은 요청을 한 줄로 할 수 있습니다.

에이전트로 전체 사이트를 구축할 수 있습니다

에이전트는 사이트를 생성하고 배포하며, 사용자에게 하나의 클레임 코드(claim code)를 전달합니다. 사용자는 한 번 로그인하여 확인만 하면, 에이전트가 만든 모든 것을 소유하게 됩니다.

독자를 위해 AI를 활용하세요

어시스턴트는 페이지의 내용을 바탕으로 질문에 답하며, 이는 Workers AI에서 작동합니다. 독자들은 추측하는 것을 멈추고, 사용자는 같은 질문에 두 번 답하는 것을 멈출 수 있습니다.

그리고 그것은 블록이 아닌 페이지처럼 읽힙니다.

읽기 경험은 텍스트 측정 레이아웃 엔진인 pretext를 통해 구현됩니다. 이 섹션은 데모이며, 현재 작동 중입니다.

이 단락은 실시간으로 표시됩니다. 선택해 보세요. 여기에 있는 모든 줄은 텍스트 측정 엔진인 pretext에 의해 배치되었으며, 이는 브라우저에게 리플로우(reflow)를 요청하는 대신 순수 산술 연산으로 줄 바꿈을 계산합니다. 이 엔진은 각 줄이 얼마나 넓을 수 있는지 정확히 알기 때문에, 장애물을 피하기 위해 줄의 폭을 좁혔다가 장애물이 끝나면 다시 넓힐 수 있습니다. 오른쪽에 있는 행성은 레이아웃 장애물이며, 플로팅 이미지 해킹(floating image hack)이 아닙니다. 텍스트는 잡지에서 사진 주변에 타이포그래피를 배치하는 방식처럼, 줄 단위로 그 경계 상자(bounding box) 주위를 실제로 흐릅니다. 이 과정 중 어느 것도 getBoundingClientRect나 캔버스에 텍스트를 페인트(paint)하지 않습니다. 독자들이 읽고 있는 단어들은 평범하고 선택 가능하며 스크린 리더 친화적인 DOM 텍스트이며, pretext는 각 줄이 어디에 위치해야 할지만 결정했습니다.

문서는 단순히 산문(prose)이 아닙니다. 예제, 다이어그램, 부가 설명이 혼합된 산문이며, 기존의 렌더러에서는 그 모든 것이 읽기 흐름을 방해합니다. 측정 기반 레이아웃을 사용하면 코드 샘플은 여백에 위치하고 설명은 옆에서 계속 흐르므로, 독자의 시선이 설명을 하는 예제를 찾기 위해 단락에서 벗어나는 일이 없습니다. 왼쪽에 있는 블록이 바로 그렇습니다. 실제 구문 강조가 된 샘플이며, 텍스트가 주변을 깔끔하게 감싸도록 컬럼 가장자리에 고정되어 있습니다. 이미 작성하는 것과 같은 Markdown으로, 실제로 누군가가 읽고 싶어 하는 페이지로 렌더링됩니다.

Documentation served from a global edge network

Cloudflare에 중점을 두고,

사용자님 계정에서 실행됩니다.

모든 docs.dev 사이트는 사용자님의 Cloudflare 계정에 있는 Worker이며 — 독자가 있는 곳 근처의 엣지(edge)에서 제공되고, 리포지토리에 푸시될 때마다 재구축되며, 사용하시는 플랜에 따라 청구됩니다. 대시보드에서 커스텀 도메인을 추가하면 사이트가 이를 연결하도록 요청하고; 한 번 승인만 거치면 바로 사용할 수 있습니다. 독자와 페이지 사이에 docs.dev 서버는 존재하지 않습니다.

직접 고른 부품들로 구축되었습니다.

독점적인 렌더러도, 미스터리한 호스팅도 없습니다. docs.dev는 소스 코드를 읽을 수 있는 세 가지 요소들을 조립하며 — 그리고 나중에 떠나더라도 이 모든 것을 사용자님이 보유하게 됩니다.

읽기 엔진 (The reading engine)

pretext

순수 산술(arithmetic)로 모든 줄을 배치하는 텍스트 측정 엔진으로, 마치 잡지 페이지처럼 산문이 그림 주변을 흐르도록 합니다.

docs 프레임워크 (The docs framework)

Fumadocs

MDX 페이지, 사이드바 및 검색 기능, OpenAPI 사양으로부터의 API 레퍼런스 생성 — 문서 사이트의 지루한 부분들이 오픈 소스로 제대로 처리됩니다.

플랫폼 (The platform)

Cloudflare

사용자님의 사이트는 사용자님 계정의 Worker입니다: 푸시-투-배포 빌드, 초안 작성 및 이미지를 위한 Workers AI, 한 번의 승인만 거치면 가능한 커스텀 도메인까지.

모든 것이 사용자님의 것입니다. 가져갈 것도 없습니다.

사용자 리포지토리가 진실의 원천입니다 (Your repo is the source of truth)

모든 페이지는 GitHub 리포지토리 내의 MDX 파일입니다. 내보낼 것도, 탈출할 것도 없습니다 — docs.dev를 떠나도 비용이 들지 않기 때문에, 바로 신뢰할 수 있습니다.

발행 전 검토 초안 (Review-before-publish drafts)

공유된 초안은 브랜치에 존재하며, 실제 페이지와 정확하게 렌더링되고, 한 번의 클릭으로 게시하거나 폐기할 수 있습니다.

편집자에게 귀속되는 커밋 (Commits attributed to the editor)

팀원들은 자신들로 발행합니다 — 사용자님의 문서에서 git blame을 확인하면 의미가 있습니다. 공유된 봇 토큰이 필요하지 않습니다.

팀 로그인 (Team sign-in)

docs.dev 계정으로 팀원을 초대할 수 있습니다 — 중앙 집중식 멤버십, 역할 및 권한 회수. 공유된 자격 증명이 필요하지 않습니다.

한 번의 승인만 필요한 커스텀 도메인 (Custom domains, one approval)

Cloudflare에 도메인을 추가하고, 해당 도메인에서 /admin을 열고, 대시보드에서 'Approve'를 클릭합니다. 다시 붙여넣을 토큰이 없습니다, 영원히.

독자들이 무엇을 묻는지 파악하세요 (Know what readers ask)

Anonymous Ask-AI 인사이트는 사람들이 무엇을 검색했는지, 그리고 문서가 답변할 수 없었던 것이 무엇인지를 보여줍니다—문서화에 대한 버그 트래커입니다.

2분 만에 완성하는 당신의 문서 사이트.

사이트를 만들고 한 번의 클릭으로 배포하거나, 프롬프트를 에이전트에게 전달하여 결과를 바로 가져오기만 하면 됩니다. 이 전체 사이트가 템플릿입니다.