Qual Licença de Visualizador .NET Você Realmente Precisa? Um Guia Completo
Qual Licença de Visualizador .NET Você Realmente Precisa? Um Guia Completo
Quando você finalmente entrega uma API limpa e versionada, o próximo obstáculo costuma ser o visualizador de documentação. O conjunto de recursos geralmente está perfeito, mas o modelo de licenciamento pode ser uma armadilha oculta que atrasa a adoção por equipes, parceiros ou clientes.
Neste artigo desmistificamos as três opções principais de licenciamento para o visualizador de documentação .NET da Doconut — Developer, Site e SDK — e oferecemos uma estrutura prática de tomada de decisão para que você escolha o plano certo na primeira tentativa.
Sumário
- Por que o licenciamento importa para a documentação de APIs
- A Licença Developer – Ideal para Pequenas Equipes
- A Licença Site – Dimensionando a Documentação em Vários Portais
- A Licença SDK – Incorporando o Visualizador em Seu Próprio Produto
- Matriz de Decisão: Checklist Rápido
- Considerações Finais & Próximos Passos
Por que o licenciamento importa para a documentação de APIs {#por-que-licenciamento-importa-para-documentacao-de-apis}
- Conformidade: Licenciamento incorreto pode gerar alertas de auditoria e taxas inesperadas.
- Desempenho: Alguns planos desbloqueiam pipelines avançados de renderização (OpenAPI 3.0, Swagger, RAML) e colaboração em tempo real que mantêm a documentação ágil.
- Escalabilidade: À medida que sua organização cresce, o modelo de custos deve evoluir sem exigir a rearquitetura completa do pipeline de documentação.
Escolher a licença errada não só eleva os custos, como pode limitar funcionalidades — como sincronização Git entre repositórios, edição baseada em funções ou marca branca — essenciais para fluxos de trabalho DevOps modernos.
A Licença Developer – Ideal para Pequenas Equipes {#a-licenca-developer-ideal-para-pequenas-equipes}
Quem Deve Considerar?
- Desenvolvedores solo ou pequenos squads (1‑5 engenheiros) construindo uma ferramenta interna ou um protótipo.
- Equipes que precisam de apenas uma instância do visualizador incorporada a um único aplicativo.
- Projetos onde a documentação está intimamente ligada a um único código‑fonte.
Principais Recursos
| Recurso | O que Significa para Seu Projeto |
|---|---|
| Renderização nativa de especificação de API | Suporta OpenAPI, Swagger, RAML prontamente com realce de sintaxe completo. |
| Edição colaborativa ao vivo | Co‑autoria em tempo real limitada a um projeto; ideal para iterações rápidas. |
| Documentos pesquisáveis ilimitados | Indexa todos os arquivos markdown, HTML ou YAML dentro do projeto para busca instantânea. |
| Sincronização Git | Sincronismo one‑to‑one com repositório — envie alterações, receba atualizações e mantenha o histórico de versões alinhado ao código. |
Visão Geral de Preços
- US$ 199 por desenvolvedor por ano (taxa fixa).
- Sem cobranças por assento ou por instância.
Quando Desistir
Se você antecipa:
- Múltiplos sites de documentação (portais de clientes, docs de parceiros), ou
- Escalar além de um único repositório,
a Licença Developer rapidamente se tornará um gargalo de custos.
Analogia: Pense nela como uma cápsula de café de dose única — perfeita para uma xícara, mas você precisará de uma máquina completa para um escritório movimentado.
A Licença Site – Dimensionando a Documentação em Vários Portais {#a-licenca-site-dimensionando-a-documentacao-em-varios-portais}
Quem Deve Considerar?
- Times empresariais que operam várias ferramentas internas, portais de APIs públicas ou bases de conhecimento acessadas por centenas de usuários.
- Empresas que precisam de branding consistente e controle de acesso unificado em todos os pontos de documentação.
Principais Recursos
| Recurso | Benefício |
|---|---|
| Instâncias de visualizador ilimitadas | Implante o visualizador em qualquer número de sites, intranets ou portais SaaS. |
| Gerenciamento centralizado de licenças | Dashboard para atribuir, revogar e auditar licenças em toda a organização. |
| Edição ao vivo em equipe com RBAC | Funções granulares (autor, revisor, admin) reforçam a governança. |
| Integração Git multi‑repo | Conecte monorepos ou repositórios dispersos e mantenha todos os conjuntos de docs sincronizados. |
| Suporte prioritário & SLA | Tempo de resposta de 24 horas, garantindo o mínimo de downtime. |
Visão Geral de Preços
- Base: US$ 4.999 por ano para até 20 sites.
- Sites adicionais: US$ 250 por site por ano.
Quando Compensa
- Você opera um portal de desenvolvedores público que precisa permanecer em sincronia com as APIs em produção.
- Seu repositório interno de conhecimento é o ponto único de verdade para dezenas de equipes.
- O custo de atualizações manuais de documentação supera a taxa de assinatura.
Analogia: É a passagem de uma garagem de um carro para um estacionamento de tamanho completo — espaço para escalar sem precisar parar a cada nova chegada.
A Licença SDK – Incorporando o Visualizador em Seu Próprio Produto {#a-licenca-sdk-incorporando-o-visualizador-em-seu-proprio-produto}
Quem Deve Considerar?
- Fornecedores que criam produtos comerciais que incorporam o visualizador .NET (ex.: IDEs desktop, consoles em nuvem, plataformas on‑premise).
- Times que exigem marca branca e acesso total ao código fonte para adaptar o visualizador à sua identidade.
Principais Recursos
| Recurso | O que Desbloqueia |
|---|---|
| Acesso total ao código fonte | Modifique pipeline de renderização, componentes UI ou integre autenticação proprietária. |
| Distribuição ilimitada | Envie o visualizador para qualquer número de instalações de usuários finais sem taxas por assento. |
| Marca branca | Remova a marca Doconut, aplique temas personalizados e controle a aparência. |
| Gerente de conta técnica dedicado | Linha direta para orientação de integração, otimização de performance e alinhamento de roadmap. |
Visão Geral de Preços
- Taxa única: US$ 12.499 por direitos perpétuos.
- Manutenção opcional: US$ 2.999 por ano (cobre atualizações, patches de segurança e suporte).
Quando É a Escolha Certa
- A proposição de valor do seu produto depende de documentação in‑app (ex.: extensão do Visual Studio que exibe especificação de API inline).
- Você precisa de distribuição irrestrita — o visualizador viaja com cada cópia do seu software.
- Consistência de marca e customização ao nível do código são requisitos não negociáveis.
Analogia: Comprar o bloco do motor para o seu próprio carro — caro inicialmente, mas você possui o motor completo e pode rodar o quanto quiser.
Matriz de Decisão: Checklist Rápido {#matriz-de-decisao-checklist-rapido}
| Pergunta | Licença Recomendada | Por quê |
|---|---|---|
| Quantos locais distintos o visualizador aparecerá? | Developer → 1‑2 locais Site → 3+ locais | A Licença Site elimina limites por instância. |
| Você precisa distribuir o visualizador para usuários finais? | SDK | Distribuição ilimitada e marca branca. |
| É necessário branding ou acesso ao código fonte? | SDK | Acesso total ao código e remoção de marca. |
| Qual modelo de custo prefere? | Developer → anual por assento Site → anual por site SDK → investimento único inicial | Alinha‑se ao ciclo orçamentário. |
Dica: Mantenha esta matriz em um briefing de projeto ou documento de planejamento de sprint; ela evidencia rapidamente a licença correta sem necessidade de idas e vindas com a equipe de vendas.
Considerações Finais & Próximos Passos {#consideracoes-finais-proximos-passos}
Escolher a licença correta do visualizador .NET não é uma decisão “tamanho‑único”. Ela se apoia em três pilares:
- Escopo da implantação – aplicativo único vs. múltiplos portais vs. integração em produto.
- Requisitos de distribuição – uso interno apenas ou embutido em oferta comercial.
- Ciclos de orçamento – gasto recorrente anual vs. investimento de capital upfront.
Ao alinhar o fluxo de trabalho da sua equipe, a trajetória de crescimento e as restrições financeiras com os recursos listados acima, você evita upgrades de licença custosos no futuro e mantém a documentação fluindo sem interrupções.
Pronto para confirmar a licença ideal?
- Acesse doconut.com/pricing e use o seletor interativo.
- Baixe a Planilha Seletora de Licenças para mapear suas respostas da matriz de decisão.
- Se precisar de um mergulho mais profundo, agende uma call de design de 15 minutos com nossos engenheiros de soluções para ver ao vivo edição colaborativa, renderização de especificação de API e sincronização Git.
Boa documentação, e que suas APIs sejam tão bem servidas quanto sua licença!