어떤 .NET 뷰어 라이선스가 실제로 필요하나요? 완전 가이드
어떤 .NET 뷰어 라이선스가 실제로 필요하나요? 완전 가이드
당신이 깨끗하고 버전 관리된 API를 마침내 배포했을 때, 다음 장애물은 종종 문서 뷰어이다. 기능 세트는 보통 완벽하지만, 라이선스 모델은 채택을 지연시키는 숨겨진 걸림돌이 될 수 있다.
이 글에서는 Doconut .NET 문서 뷰어의 세 가지 핵심 라이선스 옵션 — 개발자, 사이트, 그리고 SDK — 를 풀어보고, 첫 번째 시도부터 올바른 플랜을 선택할 수 있도록 실용적인 의사결정 프레임워크를 제공한다.
Table of Contents
- API 문서에 대한 라이선스가 중요한 이유
- 개발자 라이선스 – 소규모 팀에 적합
- 사이트 라이선스 – 포털 전반에 걸친 문서 확장
- SDK 라이선스 – 뷰어를 자체 제품에 내장
- 결정 매트릭스: 빠른 체크리스트
- 최종 생각 및 다음 단계
API 문서에 대한 라이선스가 중요한 이유 {#api-문서에-대한-라이선스가-중요한-이유}
- 컴플라이언스: 잘못된 라이선스는 감사 플래그와 예상치 못한 비용을 초래할 수 있다.
- 성능: 특정 플랜은 고급 렌더링 파이프라인(OpenAPI 3.0, Swagger, RAML) 및 실시간 협업을 잠금 해제하여 문서를 빠르게 유지한다.
- 확장성: 조직이 성장함에 따라 비용 모델은 완전한 문서 파이프라인 재구축 없이 진화해야 한다.
잘못된 라이선스를 선택하면 비용이 증가할 뿐 아니라 Git 동기화, 역할 기반 편집, 화이트 라벨 브랜딩 등 현대 DevOps 워크플로우에 필수적인 기능을 제한할 수 있다.
개발자 라이선스 {#개발자-라이선스}
누가 고려해야 할까?
- 단독 개발자 또는 소규모 팀(1‑5명) 이 내부 도구나 프로토타입을 구축할 때.
- 단일 뷰어 인스턴스만 하나의 애플리케이션에 삽입하려는 경우.
- 문서가 단일 코드베이스에 밀접하게 연결된 프로젝트.
핵심 기능
| 기능 | 프로젝트에 의미하는 바 |
|---|---|
| 네이티브 API 스펙 렌더링 | OpenAPI, Swagger, RAML을 즉시 지원하고 전체 구문 강조 제공. |
| 실시간 협업 편집 | 하나의 프로젝트에 제한된 실시간 공동 저작, 빠른 반복에 이상적. |
| 무제한 검색 가능한 문서 | 프로젝트 내 모든 markdown, HTML, YAML 파일을 색인화하여 즉시 조회 가능. |
| Git 동기화 | 일대일 저장소 동기화—변경 푸시, 업데이트 풀, 코드와 버전 히스토리 정렬. |
가격 한눈에
- 연간 개발자당 $199 (고정 요금).
- 좌석당 또는 인스턴스당 추가 비용 없음.
언제 포기해야 할까?
다음 상황이 예상될 경우:
- 여러 문서 사이트(고객 포털, 외부 파트너 문서) 필요, 혹은
- 단일 저장소를 넘어 확장하려는 경우,
개발자 라이선스는 비용 병목이 될 수 있다.
비유: 한 잔 커피용 포드와 같다— 한 잔에 딱 맞지만 번화한 사무실에서는 전체 머신이 필요하다.
사이트 라이선스 {#사이트-라이선스}
누가 고려해야 할까?
- 엔터프라이즈 팀이 여러 내부 도구, 공개 API 포털, 혹은 수백 명이 접근하는 지식 베이스를 운영할 때.
- 모든 문서 접점에서 일관된 브랜딩과 통합 접근 제어가 필요한 회사.
핵심 기능
| 기능 | 혜택 |
|---|---|
| 무제한 뷰어 인스턴스 | 웹 사이트, 인트라넷, SaaS 포털 어디에든 뷰어 배포 가능. |
| 중앙 라이선스 관리 | 조직 전체에 라이선스 할당, 해지, 감사를 위한 대시보드 제공. |
| 팀 전체 실시간 편집 + RBAC | 저자, 검토자, 관리자 등 세분화된 역할로 거버넌스 강화. |
| 다중 저장소 Git 통합 | 모노레포 또는 서로 다른 저장소를 연결해 모든 문서 세트를 동기화. |
| 우선 지원 및 SLA | 24시간 응답 창 보장, 다운타임 최소화. |
가격 한눈에
- 기본: 연 $4,999 (최대 20 사이트까지)
- 추가 사이트: 사이트당 연 $250
언제 투자 가치가 있는가
- 공개 개발자 포털을 운영해 프로덕션 API와 동기화해야 할 때.
- 내부 지식 베이스가 수십 팀의 단일 진실 근원일 때.
- 수작업 문서 업데이트 비용이 구독료를 초과할 때.
비유: 단일 차고에서 전체 주차장으로 확장하는 것— 매번 차를 끌어다 놓을 필요 없이 규모를 키울 수 있다.
SDK 라이선스 {#sdk-라이선스}
누가 고려해야 할까?
- 상용 제품에 .NET 뷰어를 내장하는 벤더(예: 데스크톱 IDE, 클라우드 콘솔, 온프레미스 플랫폼).
- 화이트 라벨링과 전체 소스 접근이 필요한 팀.
핵심 기능
| 기능 | 열어주는 것 |
|---|---|
| 전체 소스 접근 | 렌더링 파이프라인, UI 컴포넌트 수정 또는 자체 인증 통합 가능. |
| 무제한 배포 | 최종 사용자 설치 수에 제한 없이 뷰어 제공, 좌석당 비용 없음. |
| 화이트 라벨링 | Doconut 브랜딩 제거, 커스텀 테마 적용, 외관 제어. |
| 전담 기술 담당자 | 통합 가이드, 성능 튜닝, 로드맵 정렬을 위한 직접 연락 창구 제공. |
가격 한눈에
- 일시불: $12,499 영구 권리
- 선택적 유지보수: 연 $2,999 (업데이트, 보안 패치, 지원 포함)
언제 올바른 선택인가
- 제품의 핵심 가치 제안이 인앱 문서에 달려 있을 때(예: Visual Studio 확장에 API 스펙 인라인 표시).
- 무제한 배포가 필요할 때— 뷰어가 소프트웨어마다 함께 이동.
- 브랜드 일관성과 소스 수준 커스터마이징이 절대적일 때.
비유: 자동차 엔진 블록을 직접 구매하는 것— 초기 비용은 높지만 파워트레인을 완전히 소유해 원하는 만큼 달릴 수 있다.
결정 매트릭스: 빠른 체크리스트 {#결정-매트릭스-빠른-체크리스트}
| 질문 | 권장 라이선스 | 이유 |
|---|---|---|
| 뷰어가 나타날 서로 다른 위치는 몇 개입니까? | 개발자 → 1‑2곳 사이트 → 3+곳 | 사이트 라이선스는 인스턴스 제한을 없앤다. |
| 뷰어를 최종 사용자에게 배포해야 합니까? | SDK | 무제한 배포와 화이트 라벨링 제공. |
| 브랜딩이나 소스 코드 접근이 필요합니까? | SDK | 전체 소스 접근 및 브랜드 제거. |
| 선호하는 비용 모델은? | 개발자 → 연간 좌석당 사이트 → 연간 전체 사이트 SDK → 일시불 초기 투자 | 예산 주기에 맞춤. |
팁: 이 매트릭스를 프로젝트 브리프나 스프린트 플래닝 문서에 보관하면 영업팀과의 반복적인 논의 없이도 올바른 라이선스를 빠르게 파악할 수 있다.
최종 생각 및 다음 단계 {#최종-생각-및-다음-단계}
올바른 .NET 뷰어 라이선스를 선택하는 것은 “모두에게 맞는 하나”가 아니다. 다음 세 가지 축을 기준으로 판단한다.
- 배포 범위 – 단일 앱 vs. 다중 포털 vs. 제품 통합.
- 배포 방식 – 내부 전용만 사용할지, 상용 제품에 번들링할지.
- 예산 주기 – 연간 지속 비용 vs. 초기 자본 투자.
위에 나열된 기능과 요구 사항을 팀의 워크플로, 성장 궤적, 재무 제약에 맞추면 향후 라이선스 업그레이드 비용을 피하고 문서 흐름을 원활히 유지할 수 있다.
올바른 라이선스를 바로 확보하려면?
- doconut.com/pricing 에서 인터랙티브 선택기를 이용하세요.
- License Selector Worksheet 를 다운로드해 결정 매트릭스의 답변을 매핑하세요.
- 더 깊은 논의가 필요하면, 15분 설계 상담을 예약해 솔루션 엔지니어와 실시간 데모(협업 편집, API 스펙 렌더링, Git 동기화)를 확인하세요.
문서화에 즐거움을, API에는 풍부함을!