자주 배포되는 문서 형식
문서 호스팅이 복잡해지는 지점
도구보다 사이트가 커질 때
호스팅형 문서 도구는 편하지만 브랜드 표현, 커스텀 페이지, 최종 사이트 제어권에서 한계가 생기기 쉽습니다.
wiki만으로는 부족할 때
메모에는 위키가 충분하지만 공개 제품 문서는 검색, 읽기 쉬운 내비게이션, 커스텀 도메인, 메타데이터, 첫인상이 필요합니다.
셀프 호스팅이 문서 작업을 잡아먹을 때
서버, SSL, 배포 hook, 릴리즈 관리가 문서 작성 시간과 경쟁해서는 안 됩니다.
게시 전 빌드 확인
생성된 폴더 업로드
Docusaurus는 보통 build, VitePress는 .vitepress/dist, MkDocs는 site에 결과물을 만듭니다. 소스 Markdown이 아니라 생성된 파일을 올리세요.
base path 확인
문서가 하위 경로나 프로젝트 경로에서 열릴 예정이면 프레임워크 base URL이 최종 URL과 맞는지 확인합니다.
검색과 탐색 테스트
프로덕션 빌드를 로컬에서 열어 검색 인덱스, 사이드바 링크, 버전 경로, 딥링크를 공개 URL 공유 전에 확인하세요.
자산 캐시 가능성
문서 사이트는 작은 이미지, 폰트, JavaScript 파일이 많습니다. 정적 배포는 이런 자산을 캐시하기 쉽게 만듭니다.
여러 종류의 문서 사이트에 맞습니다
오픈소스 프로젝트 문서
가이드, 변경 기록, 마이그레이션 문서를 별도 운영 프로젝트로 키우지 않고 브랜드 도메인에 게시하세요.
API 레퍼런스
검색, 내비게이션, 코드 친화 레이아웃이 있는 레퍼런스 사이트를 깔끔하게 공개할 수 있습니다.
팀 핸드북
엔지니어링 핸드북, runbook, 업무 절차 문서를 정돈된 사이트 구조로 운영하세요.
제품 문서
온보딩 문서, 설정 가이드, 기능 레퍼런스를 지역에 상관없이 빠르게 열리는 사이트로 제공하세요.
디자인 시스템
컴포넌트 사용법, 토큰, 패턴을 제품과 함께 확장되는 탐색 가능한 사이트로 공개하세요.
주요 정적 문서 스택과 함께 사용
자주 묻는 질문
VitePress나 Docusaurus 결과물을 배포할 수 있나요?
네. 프레임워크 빌드를 먼저 실행한 뒤 생성된 정적 결과물 디렉터리를 업로드하세요. DeployPages가 최종 HTML, CSS, JavaScript, 자산을 제공합니다.
문서 사이트의 커스텀 도메인은 어떻게 연결하나요?
배포 후 도메인을 추가하고 안내된 대상에 DNS 레코드를 연결하세요. DeployPages가 HTTPS를 자동으로 준비합니다.
비공개 문서도 호스팅할 수 있나요?
현재 가장 잘 맞는 사용 사례는 공개 문서와 오픈 제품 문서입니다. 접근 제어는 확장 중이지만 핵심 흐름은 정적 사이트 게시입니다.
SEO에도 도움이 되나요?
도움이 될 수 있습니다. 정적 HTML, 깔끔한 URL, 유용한 메타데이터, 빠른 전송은 문서의 검색 노출을 위한 기술 기반을 강화합니다.
문서 빌드를 실제 사이트로 게시하세요
생성된 문서 폴더를 업로드하고 독자가 빠르게 답을 찾을 수 있는 브랜드 문서 사이트를 만드세요.
HTML, CSS, JS와 일반적인 정적 문서 자산을 지원합니다.