Яку ліцензію .NET Viewer вам дійсно потрібна? Повний гід
Яку ліцензію .NET Viewer вам дійсно потрібна? Повний гід
Коли ви нарешті випускаєте чистий, контрольований версіями API, наступною перешкодою часто стає переглядач документації. Набір функцій зазвичай ідеальний, але модель ліцензування може стати прихованою підводною каменем, що затримує впровадження серед команд, партнерів або клієнтів.
У цій статті ми розкриваємо три основні варіанти ліцензування для Doconut .NET переглядача документації — Developer, Site та SDK — і надаємо практичну структуру прийняття рішень, щоб ви могли обрати правильний план з першого разу.
Зміст
- Чому ліцензування важливе для API документації
- Ліцензія Developer – ідеально для малих команд
- Ліцензія Site – масштабування документації через портали
- Ліцензія SDK – вбудовування переглядача у ваш власний продукт
- Матриця рішень: швидкий чек‑лист
- Заключні думки та наступні кроки
Чому ліцензування важливе для API документації {#чому-ліцензування-важливе-для-api-документації}
- Відповідність: Неправильне ліцензування може викликати аудиторські позначки та несподівані збори.
- Продуктивність: Деякі плани розблоковують розширені конвеєри рендерингу (OpenAPI 3.0, Swagger, RAML) та співпрацю в реальному часі, що робить документи швидкими.
- Масштабованість: З ростом вашої організації модель витрат повинна еволюціонувати без необхідності повного перепроектування конвеєру документації.
Вибір невірної ліцензії не лише підвищує витрати, а й може обмежити можливості — такі як синхронізація Git між репозиторіями, редагування за ролями або брендінг без логотипу — критично важливі для сучасних DevOps процесів.
Ліцензія Developer {#ліцензія-developer}
Кому варто розглядати це?
- Самостійним розробникам або малим групам (1‑5 інженерів), які створюють внутрішній інструмент або прототип.
- Командам, яким потрібен лише один екземпляр переглядача, вбудований в один застосунок.
- Проєкти, де документація щільно пов'язана з однією кодовою базою.
Основні функції
| Функція | Що це означає для вашого проєкту |
|---|---|
| Відображення специфікації API нативно | Підтримує OpenAPI, Swagger, RAML «з коробки» з повним підсвічуванням синтаксису. |
| Редагування в реальному часі | Співпраця у реальному часі, обмежена одним проєктом; ідеально для швидких ітерацій. |
| Необмежена пошукова документація | Індексує всі markdown, HTML або YAML файли в проєкті для миттєвого пошуку. |
| Синхронізація Git | Синхронізація один-до-одного з репозиторієм — відправляйте зміни, отримуйте оновлення та зберігайте історію версій у відповідності з кодом. |
Ціновий огляд
- 199 $ за розробника на рік (фіксована плата).
- Без додаткових платежів за місце чи інстанс.
Коли варто відмовитися
Якщо ви очікуєте:
- Кілька сайтів документації (портали для клієнтів, зовнішня документація партнерів), або
- Масштабування за межами одного репозиторію,
Ліцензія Developer швидко стане фінансовим вузьким місцем.
Аналогія: Уявіть це як одноразову кавову порцію — ідеально для однієї чашки, але для жвавого офісу потрібна повна кавомашина.
Ліцензія Site {#ліцензія-site}
Кому варто розглядати це?
- Командам підприємств, які керують кількома внутрішніми інструментами, публічними порталами API або базою знань, доступною сотням користувачів.
- Компаніям, яким потрібен послідовний брендинг та уніфікований контроль доступу у всіх точках взаємодії з документацією.
Основні функції
| Функція | Перевага |
|---|---|
| Необмежені екземпляри переглядача | Розгорніть переглядач на будь‑якій кількості веб‑сайтів, інтранетів або SaaS порталів. |
| Централізоване управління ліцензіями | Панель керування для призначення, відкликання та аудиту ліцензій у всій організації. |
| Командне редагування в реальному часі з RBAC | Тонко налаштовані ролі (автор, рев’юер, адміністратор) забезпечують управління. |
| Інтеграція Git з кількома репозиторіями | Підключення монорепозиторіїв або різних репозиторіїв та синхронізація всіх наборів документів. |
| Пріоритетна підтримка та SLA | Вікно відповіді 24 години, гарантує мінімальний простій. |
Ціновий огляд
- Базова: 4 999 $ на рік для до 20 сайтів.
- Додаткові сайти: 250 $ за сайт на рік.
Коли це вигідно
- Ви управляєте публічним порталом розробників, який має залишатися синхронізованим з продукційними API.
- Ваша внутрішня база знань є єдиною точкою правди для десятків команд.
- Вартість ручних оновлень документації перевищує вартість підписки.
Аналогія: Це перехід від гаража для однієї машини до повноцінного паркінгу — достатньо простору для масштабування без зупинок.
Ліцензія SDK {#ліцензія-sdk}
Кому варто розглядати це?
- Виробникам, які створюють комерційні продукти, що вбудовують .NET переглядач (наприклад, десктопні IDE, хмарні консолі, on‑premise платформи).
- Командам, яким потрібен білий бренд (white‑labeling) та повний доступ до коду для налаштування переглядача під їх бренд.
Основні функції
| Функція | Що це розблоковує |
|---|---|
| Повний доступ до вихідного коду | Модифікуйте конвеєр рендерингу, UI‑компоненти або інтегруйте власну автентифікацію. |
| Необмежене розповсюдження | Поширюйте переглядач на будь‑яку кількість інсталяцій кінцевих користувачів без платежів за місце. |
| Білий бренд (white‑labeling) | Видаліть брендинг Doconut, застосуйте кастомні теми та контролюйте зовнішній вигляд. |
| Присвячений менеджер технічного обліку | Прямий зв’язок для рекомендацій щодо інтеграції, оптимізації продуктивності та узгодження дорожньої карти. |
Ціновий огляд
- Одноразова плата: 12 499 $ за вічні права.
- Опціональне обслуговування: 2 999 $ на рік (включає оновлення, патчі безпеки та підтримку).
Коли це правильний вибір
- Пропозиція цінності вашого продукту базується на документації всередині додатку (наприклад, розширення Visual Studio, що показує специфікацію API вбудовано).
- Потрібно необмежене розповсюдження — переглядач постачається з кожною копією вашого програмного забезпечення.
- Узгодженість бренду та кастомізація на рівні коду є невід’ємними.
Аналогія: Купівля блоку двигуна для вашого власного автомобіля — дорого спочатку, але ви володієте трансмісією повністю і можете їхати куди завгодно.
Матриця рішень {#матриця-рішень}
| Питання | Рекомендована ліцензія | Чому |
|---|---|---|
| Скільки різних місць буде використано переглядач? | Developer → 1‑2 локації Site → 3+ локації | Ліцензія Site знімає обмеження на інстанси. |
| Чи потрібно вам відправляти переглядач кінцевим користувачам? | SDK | Необмежене розповсюдження та white‑labeling. |
| Чи потрібен брендинг або доступ до вихідного коду? | SDK | Повний доступ до коду та видалення бренду. |
| Яка ваша перевага в моделі вартості? | Developer → щорічна оплата за місце Site → щорічна оплата за сайт SDK → одноразова передоплата | Відповідає вашому бюджету. |
Порада: Тримайте цю матрицю під рукою у проєктному брифі або документі планування спринту; вона швидко визначає потрібну ліцензію без необхідності обговорювати її з відділом продажу.
Заключні думки {#заключні-думки}
Вибір правильної ліцензії .NET переглядача не є «один‑розмір‑все‑підходить» рішенням. Він спирається на три стовпи:
- Обсяг розгортання — один застосунок проти кількох порталів проти інтеграції в продукт.
- Вимоги до розповсюдження — лише внутрішнє використання або в комплекті з комерційною пропозицією.
- Бюджетний цикл — повторювані щорічні витрати проти одноразових капітальних інвестицій.
Вирівнюючи робочий процес вашої команди, траєкторію зростання та фінансові обмеження з переліченими вище функціями, ви зможете уникнути дорогих оновлень ліцензії в майбутньому та забезпечити безперебійну роботу документації.
Готові зафіксувати правильну ліцензію?
- Відвідайте doconut.com/pricing і скористайтеся інтерактивним селектором.
- Завантажте License Selector Worksheet, щоб зіставити ваші відповіді з матриці рішень.
- Якщо потрібен глибший огляд, заплануйте 15‑хвилинний дизайнерський дзвінок з нашими інженерами‑рішеннями для живої демонстрації спільного редагування, відображення специфікації API та синхронізації Git.
Щасливого документування, і нехай ваші API будуть настільки ж добре підтримані, як ваша ліцензія!