¿Qué licencia de visor .NET realmente necesita? Una guía completa
¿Qué licencia de visor .NET realmente necesita? Una guía completa
Cuando finalmente despliegas una API limpia y con control de versiones, el siguiente obstáculo suele ser el visor de documentación. El conjunto de funciones suele ser perfecto, pero el modelo de licenciamiento puede ser un inconveniente oculto que frena la adopción entre equipos, socios o clientes.
En este artículo desmitificamos las tres opciones principales de licenciamiento para el visor de documentación .NET de Doconut—Developer, Site y SDK—y te ofrecemos un marco práctico de toma de decisiones para que puedas seleccionar el plan adecuado la primera vez.
Tabla de contenidos
- Por qué la licencia importa para la documentación de API
- La licencia Developer – Ideal para equipos pequeños
- La licencia Site – Escalando la documentación a través de portales
- La licencia SDK – Incorporando el visor en tu propio producto
- Matriz de decisiones: lista de verificación rápida
- Reflexiones finales y próximos pasos
Por qué la licencia importa para la documentación de API {#por-que-la-licencia-importa-para-la-documentacion-de-api}
- Cumplimiento: Una licencia incorrecta puede generar alertas de auditoría y cargos inesperados.
- Rendimiento: Algunos planes desbloquean pipelines de renderizado avanzados (OpenAPI 3.0, Swagger, RAML) y colaboración en tiempo real que mantienen la documentación ágil.
- Escalabilidad: A medida que tu organización crece, el modelo de costos debe evolucionar sin forzar una re‑arquitectura completa del pipeline de documentación.
Elegir la licencia equivocada no solo infla los costos, sino que también puede limitar capacidades—como sincronización Git entre repositorios, edición basada en roles o branding sin marca—críticas para flujos de trabajo DevOps modernos.
La licencia Developer {#la-licencia-developer-ideal-para-equipos-pequenos}
¿Quién debería considerarla?
- Desarrolladores solos o equipos pequeños (1‑5 ingenieros) construyendo una herramienta interna o una prueba de concepto.
- Equipos que necesiten solo una instancia del visor incrustada en una única aplicación.
- Proyectos donde la documentación está estrechamente acoplada a una única base de código.
Características principales
| Funcionalidad | Qué significa para su proyecto |
|---|---|
| Renderizado nativo de especificaciones API | Soporta OpenAPI, Swagger, RAML listo para usar con resaltado de sintaxis completo. |
| Edición colaborativa en tiempo real | Co‑autoría en tiempo real limitada a un proyecto; ideal para iteraciones rápidas. |
| Documentos ilimitados buscables | Indexa todos los archivos markdown, HTML o YAML dentro del proyecto para búsquedas instantáneas. |
| Sincronización Git | Sincronización uno‑a‑uno del repositorio: envía cambios, extrae actualizaciones y mantiene el historial de versiones alineado con el código. |
Resumen de precios
- $199 por desarrollador al año (tarifa fija).
- Sin cargos adicionales por asiento o por instancia.
Cuándo descartar
Si anticipas:
- Múltiples sitios de documentación (portales de clientes, documentación de socios externos), o
- Escalar más allá de un solo repositorio,
la licencia Developer se convertirá rápidamente en un cuello de botella de costos.
Analogía: Piensa en ello como una cápsula de café de una sola porción—perfecta para una taza, pero necesitarás una máquina completa para una oficina bulliciosa.
La licencia Site {#la-licencia-site-escalando-la-documentacion-a-traves-de-portales}
¿Quién debería considerarla?
- Equipos empresariales que gestionan varias herramientas internas, portales de API públicas o una base de conocimiento accesible por cientos de usuarios.
- Empresas que necesiten branding consistente y control de acceso unificado en todos los puntos de documentación.
Características principales
| Funcionalidad | Beneficio |
|---|---|
| Instancias ilimitadas del visor | Despliega el visor en cualquier número de sitios web, intranets o portales SaaS. |
| Gestión centralizada de licencias | Panel para asignar, revocar y auditar licencias en toda la organización. |
| Edición colaborativa a nivel de equipo con RBAC | Roles detallados (autor, revisor, administrador) que hacen cumplir la gobernanza. |
| Integración Git multi‑repositorio | Conecta monorepos o repositorios dispares y mantiene cada conjunto de documentos sincronizado. |
| Soporte prioritario y SLA | Ventana de respuesta de 24 horas, garantizando tiempo de inactividad mínimo. |
Resumen de precios
- Base: $4,999 al año para hasta 20 sitios.
- Sitios adicionales: $250 por sitio al año.
Cuándo resulta rentable
- Operas un portal de desarrolladores público que necesita mantenerse sincronizado con las APIs en producción.
- Tu base de conocimiento interna es el punto único de verdad para decenas de equipos.
- El costo de actualizar la documentación manualmente supera la tarifa de suscripción.
Analogía: Es el salto de un garaje para un solo coche a un estacionamiento de tamaño completo—espacio para escalar sin detenerse cada vez.
La licencia SDK {#la-licencia-sdk-incorporando-el-visor-en-tu-propio-producto}
¿Quién debería considerarla?
- Proveedores que construyen productos comerciales que incrustan el visor .NET (p. ej., IDEs de escritorio, consolas en la nube, plataformas on‑premise).
- Equipos que requieren marca blanca y acceso completo al código fuente para adaptar el visor a su marca.
Características principales
| Funcionalidad | Qué desbloquea |
|---|---|
| Acceso completo al código fuente | Modifica la canalización de renderizado, componentes UI o integra autenticación propietaria. |
| Distribución ilimitada | Envía el visor a cualquier número de instalaciones de usuarios finales sin tarifas por asiento. |
| Marca blanca | Elimina la marca Doconut, aplica temas personalizados y controla la apariencia. |
| Gestor de cuenta técnica dedicado | Línea directa para orientación de integración, afinación de rendimiento y alineación con la hoja de ruta. |
Resumen de precios
- Pago único: $12,499 por derechos perpetuos.
- Mantenimiento opcional: $2,999 al año (cubre actualizaciones, parches de seguridad y soporte).
Cuándo es la elección correcta
- La propuesta de valor de tu producto depende de la documentación integrada (por ejemplo, una extensión de Visual Studio que muestra especificaciones API en línea).
- Necesitas distribución sin restricciones—el visor viaja con cada copia de tu software.
- La consistencia de marca y personalización a nivel de código son innegociables.
Analogía: Comprar el bloque del motor para tu propio coche—costoso al principio, pero posees la transmisión completa y puedes conducir tanto como quieras.
Matriz de decisiones: lista de verificación rápida {#matriz-de-decisiones-lista-de-verificacion-rapida}
| Pregunta | Licencia recomendada | Por qué |
|---|---|---|
| ¿En cuántos lugares distintos aparecerá el visor? | Developer → 1‑2 ubicaciones Site → más de 3 ubicaciones | La licencia Site elimina los límites por instancia. |
| ¿Necesitas enviar el visor a los usuarios finales? | SDK | Distribución ilimitada y marca blanca. |
| ¿Se requiere personalización de marca o acceso al código fuente? | SDK | Acceso completo al código fuente y eliminación de marca. |
| ¿Cuál es tu modelo de costo preferido? | Developer → anual por asiento Site → anual por sitio SDK → pago único inicial | Se alinea con el ciclo presupuestario. |
Tip: Mantén esta matriz a mano en un brief de proyecto o documento de planificación de sprint; rápidamente muestra la licencia correcta sin necesidad de conversaciones extensas con ventas.
Reflexiones finales y próximos pasos {#reflexiones-finales-y-proximos-pasos}
Elegir la licencia correcta para el visor .NET no es una decisión de “talla única”. Se basa en tres pilares:
- Alcance del despliegue – una sola aplicación vs. varios portales vs. integración en un producto.
- Requisitos de distribución – uso interno únicamente o empaquetado con una oferta comercial.
- Ciclo de presupuesto – gasto recurrente anual vs. inversión de capital inicial.
Alineando el flujo de trabajo de tu equipo, la trayectoria de crecimiento y las restricciones financieras con las características descritas arriba, evitarás costosas actualizaciones de licencia más adelante y mantendrás la documentación fluida.
¿Listo para asegurar la licencia adecuada?
- Visita doconut.com/pricing y usa el selector interactivo.
- Descarga la Hoja de trabajo del selector de licencias para mapear tus respuestas de la matriz de decisiones.
- Si necesitas profundizar, agenda una llamada de diseño de 15 minutos con nuestros ingenieros de soluciones para una demostración en vivo de edición colaborativa, renderizado de especificaciones API y sincronización Git.
¡Feliz documentación, y que tus APIs estén tan bien atendidas como tu licencia!