Vilken .NET Viewer-licens du verkligen behöver? En komplett guide
Vilken .NET Viewer-licens du verkligen behöver? En komplett guide
När du äntligen levererar ett rent, versionsstyrt API är nästa hinder ofta dokumentationsvisaren. Funktionsuppsättningen är vanligtvis prickfri, men licensmodellen kan vara en dold hake som bromsar antagandet i team, hos partners eller kunder.
I den här artikeln avmystifierar vi de tre huvudsakliga licensalternativen för Doconut .NET-dokumentationsvisaren—Developer, Site och SDK—och ger dig en praktisk beslutsram så att du kan välja rätt plan redan från början.
Innehållsförteckning
- Varför licensiering är viktigt för API-dokumentation
- Utvecklarlicensen – Idealisk för små team
- Webbplatslicensen – Skalar dokumentation över portaler
- SDK-licensen – Bädda in visaren i din egen produkt
- Beslutsmatris: Snabbchecklista
- Avslutande tankar & nästa steg
Varför licensiering är viktigt för API-dokumentation {#varfor-licensiering-ar-viktigt-for-api-dokumentation}
- Efterlevnad: Felaktig licens kan trigga revisionsflaggor och oväntade avgifter.
- Prestanda: Vissa planer låser upp avancerade renderingspipelines (OpenAPI 3.0, Swagger, RAML) och samarbete i realtid som håller dokumenten snabba.
- Skalbarhet: När organisationen växer bör kostnadsmodellen utvecklas utan att tvinga en total omarkering av dokumentationspipen.
Att välja fel licens ökar inte bara kostnaderna utan kan också begränsa funktioner—såsom Git‑synk över repos, rollbaserad redigering eller white‑label‑branding—vilket är kritiskt för moderna DevOps‑arbetsflöden.
Utvecklarlicensen {#utvecklarlicensen}
Vem bör överväga den?
- Enskilda utvecklare eller små grupper (1‑5 ingenjörer) som bygger ett internt verktyg eller ett proof‑of‑concept.
- Team som bara behöver en visarinstans inbäddad i en enda applikation.
- Projekt där dokumentationen är tätt knuten till en enda kodbas.
Kärnfunktioner
| Funktion | Vad det betyder för ditt projekt |
|---|---|
| Inbyggd rendering av API‑specifikationer | Stöder OpenAPI, Swagger, RAML direkt med full syntax‑highlighting. |
| Live‑samarbetsredigering | Realtids‑medförfattande begränsat till ett projekt; perfekt för snabb iteration. |
| Obegränsad sökbar dokumentation | Indexerar alla markdown-, HTML‑ eller YAML‑filer i projektet för omedelbar uppslagning. |
| Git‑synk | En‑till‑en‑repo‑synk—push‑ändringar, pull‑uppdateringar och håll versionshistorik i linje med koden. |
Prisöversikt
- 199 USD per utvecklare per år (fast avgift).
- Inga per‑säte‑ eller per‑instans‑tillägg.
När du bör gå vidare
Om du förväntar dig:
- Flera dokumentationswebbplatser (kundportaler, externa partner‑docs), eller
- Skalning bortom en enda kodbas,
så blir utvecklarlicensen snabbt en kostnadsflaskehals.
Analogi: Tänk på den som en engångskaffe‑pad—perfekt för en kopp, men du behöver en hel maskin för ett livligt kontor.
Webbplatslicensen {#webbplatslicensen}
Vem bör överväga den?
- Företagsteam som driver flera interna verktyg, publika API‑portaler eller en kunskapsbas som nås av hundratals användare.
- Företag som behöver konsekvent branding och enhetlig åtkomstkontroll över alla dokumentationspunkter.
Kärnfunktioner
| Funktion | Fördel |
|---|---|
| Obegränsade visarinstanser | Distribuera visaren på valfritt antal webbplatser, intranät eller SaaS‑portaler. |
| Centraliserad licenshantering | Dashboard för att tilldela, återkalla och audita licenser i hela organisationen. |
| Team‑brett live‑redigering med RBAC | Finmaskiga roller (författare, granskningsperson, admin) säkerställer styrning. |
| Multi‑repo Git‑integration | Koppla monorepos eller separata repos och håll varje dokumentsats synkroniserad. |
| Prioriterat stöd & SLA | 24‑timmars svarstid, vilket garanterar minimal driftstopp. |
Prisöversikt
- Bas: 4 999 USD per år för upp till 20 webbplatser.
- Extra webbplatser: 250 USD per webbplats per år.
När det lönar sig
- Du driver en offentlig utvecklarportal som måste hålla sig i sync med produkt‑API:erna.
- Din interna kunskapsbas är en enda sanningskälla för dussintals team.
- Kostnaden för manuella dokumentationsuppdateringar överstiger prenumerationsavgiften.
Analogi: Det är steget från ett enbilsgarage till en fullstor parkeringsplats—rymligt att skala utan att behöva köra omkull varje gång.
SDK-licensen {#sdk-licensen}
Vem bör överväga den?
- Leverantörer som bygger kommersiella produkter där .NET‑visaren bäddas in (t.ex. desktop‑IDEer, molnkonsoler, on‑premise‑plattformar).
- Team som kräver white‑labeling och full åtkomst till källkoden för att skräddarsy visaren efter sin egen varumärkesprofil.
Kärnfunktioner
| Funktion | Vad det låser upp |
|---|---|
| Full källkodstillgång | Modifiera renderingspipeline, UI‑komponenter eller integrera egen autentisering. |
| Obegränsad distribution | Leverera visaren till valfritt antal slutanvändarinstallationer utan per‑säte‑avgifter. |
| White‑labeling | Ta bort Doconut‑branding, applicera egna teman och kontrollera utseendet helt. |
| Dedikerad teknisk kontoansvarig | Direktkontakt för integrationsvägledning, prestandaoptimering och roadmap‑anpassning. |
Prisöversikt
- Engångsavgift: 12 499 USD för eviga rättigheter.
- Valfritt underhåll: 2 999 USD per år (inkluderar uppdateringar, säkerhetspatchar och support).
När det är rätt val
- Produktens värdeerbjudande vilar på in‑app‑dokumentation (t.ex. ett Visual‑Studio‑tillägg som visar API‑specifikationer inline).
- Du behöver obegränsad distribution—visaren följer med varje kopia av din mjukvara.
- Varumärkeskonsekvens och källkodsanpassning är icke‑förhandlingsbara.
Analogi: Att köpa motorblocket till din egen bil—dyrt i början, men du äger drivkraften och kan köra hur långt du vill.
Beslutsmatris: Snabbchecklista {#beslutsmatris-snabbchecklista}
| Fråga | Rekommenderad licens | Varför |
|---|---|---|
| Hur många olika ställen ska visaren visas? | Utvecklarlicensen → 1‑2 platser Webbplatslicensen → 3+ platser | Webbplatslicensen tar bort per‑instansbegränsningar. |
| Behöver du leverera visaren till slutanvändare? | SDK-licensen | Obegränsad distribution och white‑labeling. |
| Krävs varumärkes- eller källkodstillgång? | SDK-licensen | Full källkodstillgång och varumärkesborttagning. |
| Vilken kostnadsmodell föredrar du? | Utvecklarlicensen → årlig per‑säte Webbplatslicensen → årlig per webbplats SDK-licensen → engångsinvestering | Passar din budgetcykel. |
Tips: Håll den här matrisen i ett projekt‑brief eller sprintplaneringsdokument; den visar snabbt rätt licens utan långa diskussioner med försäljning.
Avslutande tankar & nästa steg {#avslutande-tankar-nasta-steg}
Att välja rätt .NET‑visarlicens är inte ett “en‑storlek‑passar‑alla” beslut. Det vilar på tre pelare:
- Utplaceringens omfattning – en enda app vs. flera portaler vs. produktintegration.
- Distributionskrav – endast internt bruk eller inbäddat i en kommersiell produkt.
- Budgetrytm – återkommande årlig kostnad vs. ett upfront‑kapitalinvestering.
Genom att matcha ditt teams arbetsflöde, tillväxtkurva och finansiella begränsningar med funktionerna ovan kan du undvika dyra licensuppgraderingar längre fram och hålla dokumentationen flytande.
Redo att låsa rätt licens?
- Besök doconut.com/pricing och använd den interaktiva väljaren.
- Ladda ner License Selector Worksheet för att kartlägga dina svar från beslutsmatrisen.
- Om du vill ha en djupare genomgång, boka ett 15‑minuters design‑samtal med våra lösningsingenjörer för en live‑demo av samarbetsredigering, API‑specrendering och Git‑synk.
Lycka till med dokumentationen, och må dina API:er vara lika välbetjänade som din licens!