Welche .NET Viewer-Lizenz Sie wirklich benötigen? Ein vollständiger Leitfaden
Welche .NET Viewer-Lizenz Sie wirklich benötigen? Ein vollständiger Leitfaden
Wenn Sie schließlich eine saubere, versionskontrollierte API ausliefern, ist das nächste Hindernis häufig der Documentation Viewer. Der Funktionsumfang ist meist exakt passend, aber das Lizenzmodell kann ein verstecktes Stolperstein sein, das die Akzeptanz in Teams, bei Partnern oder Kunden bremst.
In diesem Artikel entmystifizieren wir die drei Kern‑Lizenzoptionen für den Doconut .NET Documentation Viewer — Developer, Site und SDK — und geben Ihnen ein praktisches Entscheidungs‑Framework, damit Sie beim ersten Mal den richtigen Plan wählen können.
Inhaltsverzeichnis
- Warum Lizenzierung bei API‑Dokumenten wichtig ist
- Die Entwicklerlizenz – Ideal für kleine Teams
- Die Site‑Lizenz – Skalierung der Dokumentation über Portale
- Die SDK‑Lizenz – Einbetten des Viewers in Ihr eigenes Produkt
- Entscheidungsmatrix: Schnell‑Checkliste
- Abschließende Gedanken & nächste Schritte
Warum Lizenzierung bei API‑Dokumenten wichtig ist {#warum-lizenzierung-bei-api-dokumenten-wichtig-ist}
- Compliance: Falsche Lizenzierung kann Prüfungsflaggen auslösen und unerwartete Gebühren nach sich ziehen.
- Performance: Bestimmte Pläne schalten erweiterte Rendering‑Pipelines (OpenAPI 3.0, Swagger, RAML) und Echtzeit‑Zusammenarbeit frei, die die Dokumentation flink halten.
- Skalierbarkeit: Mit wachsender Organisation sollte das Kostenmodell mitentwickeln, ohne dass die gesamte Dokumentations‑Pipeline neu architekturiert werden muss.
Die falsche Lizenz zu wählen erhöht nicht nur die Kosten, sondern kann auch Funktionen einschränken — wie Git‑Sync über mehrere Repositories, rollenbasierte Bearbeitung oder White‑Label‑Branding — die für moderne DevOps‑Workflows entscheidend sind.
Die Entwicklerlizenz – Ideal für kleine Teams {#die-entwicklerlizenz-ideal-fur-kleine-teams}
Wer sollte sie in Betracht ziehen?
- Einzelne Entwickler oder kleine Teams (1‑5 Ingenieure), die ein internes Tool oder einen Proof‑of‑Concept bauen.
- Teams, die nur eine Viewer‑Instanz in einer einzigen Anwendung benötigen.
- Projekte, bei denen die Dokumentation eng an einen einzelnen Code‑Base gekoppelt ist.
Kern‑Features
| Feature | Was das für Ihr Projekt bedeutet |
|---|---|
| Native API‑Spec‑Rendering | Unterstützt OpenAPI, Swagger, RAML out‑of‑the‑box mit voller Syntax‑Highlighting. |
| Live‑kollaboratives Editieren | Echtzeit‑Co‑Authoring ist auf ein Projekt beschränkt; ideal für schnelle Iterationen. |
| Unbegrenzte durchsuchbare Docs | Indexiert alle Markdown-, HTML‑ oder YAML‑Dateien innerhalb des Projekts für sofortige Suche. |
| Git‑Sync | Eins‑zu‑eins‑Repository‑Synchronisation — Änderungen pushen, Updates pullen und Versionsverlauf synchron zum Code halten. |
Preis‑Übersicht
- 199 $ pro Entwickler und Jahr (Pauschalgebühr).
- Keine zusätzlichen Sitz‑ oder Instanzgebühren.
Wann Sie davon absehen sollten
Wenn Sie erwarten:
- Mehrere Dokumentations‑Sites (Kundenportale, externe Partner‑Docs) oder
- Eine Skalierung über ein einzelnes Repository hinaus,
wird die Entwicklerlizenz schnell zum Kosten‑Engpass.
Analogie: Sie ist wie eine Einzeldosis Kaffeepads — perfekt für eine Tasse, aber für ein geschäftiges Büro benötigen Sie eine ganze Maschine.
Die Site‑Lizenz – Skalierung der Dokumentation über Portale {#die-site-lizenz-skalierung-der-dokumentation-ueber-portale}
Wer sollte sie in Betracht ziehen?
- Enterprise‑Teams, die mehrere interne Werkzeuge, öffentliche API‑Portale oder ein Wissens‑Base betreiben, auf das Hunderte von Nutzern zugreifen.
- Unternehmen, die einheitliches Branding und zentralisierte Zugriffskontrolle über alle Dokumentations‑Berührungspunkte benötigen.
Kern‑Features
| Feature | Benefit |
|---|---|
| Unbegrenzte Viewer‑Instanzen | Deployen Sie den Viewer auf beliebig vielen Websites, Intranets oder SaaS‑Portalen. |
| Zentrale Lizenzverwaltung | Dashboard zum Zuweisen, Widerrufen und Auditen von Lizenzen im gesamten Unternehmen. |
| Team‑weite Live‑Bearbeitung mit RBAC | Fein abgestufte Rollen (Autor, Reviewer, Admin) gewährleisten Governance. |
| Multi‑Repo Git‑Integration | Verbinden Sie Monorepos oder disparate Repos und halten Sie alle Doc‑Sets synchron. |
| Prioritätssupport & SLA | 24‑Stunden‑Reaktionszeit, garantiert minimale Ausfallzeiten. |
Preis‑Übersicht
- Basis: 4.999 $ pro Jahr für bis zu 20 Sites.
- Zusätzliche Sites: 250 $ pro Site und Jahr.
Wann es sich auszahlt
- Sie betreiben ein öffentliches Entwickler‑Portal, das synchron zu Produktions‑APIs bleiben muss.
- Ihr internes Wissens‑Base ist ein einziger Wahrheitsort für Dutzende von Teams.
- Die Kosten manueller Dokumentations‑Updates übersteigen das Abonnement.
Analogie: Das ist der Sprung von einer Einzelgarage zu einem vollwertigen Parkplatz — Platz zum Skalieren, ohne jedes Mal einparken zu müssen.
Die SDK‑Lizenz – Einbetten des Viewers in Ihr eigenes Produkt {#die-sdk-lizenz-einbetten-des-viewers-in-ihr-eigenes-produkt}
Wer sollte sie in Betracht ziehen?
- Anbieter, die kommerzielle Produkte bauen, die den .NET‑Viewer einbetten (z. B. Desktop‑IDEs, Cloud‑Consoles, On‑Premise‑Plattformen).
- Teams, die White‑Labeling und vollen Quellcode‑Zugriff benötigen, um den Viewer an ihre Marke anzupassen.
Kern‑Features
| Feature | Was das freischaltet |
|---|---|
| Voller Quellcode‑Zugriff | Ändern Sie die Rendering‑Pipeline, UI‑Komponenten oder integrieren Sie proprietäre Authentifizierung. |
| Unbegrenzte Distribution | Verteilen Sie den Viewer an beliebig viele End‑User‑Installationen ohne Sitz‑Gebühren. |
| White‑Labeling | Entfernen Sie Doconut‑Branding, wenden Sie eigene Themes an und steuern das Look‑and‑Feel. |
| Dedizierter Technischer Account Manager | Direkter Draht für Integrations‑Guidance, Performance‑Tuning und Roadmap‑Abstimmung. |
Preis‑Übersicht
- Einmalige Gebühr: 12.499 $ für perpetual Rechte.
- Optionale Wartung: 2.999 $ pro Jahr (umfasst Updates, Sicherheitspatches und Support).
Wann es die richtige Wahl ist
- Der Wert Ihres Produkts hängt von In‑App‑Dokumentation ab (z. B. eine Visual‑Studio‑Erweiterung, die API‑Specs inline anzeigt).
- Sie benötigen unbegrenzte Distribution — der Viewer reist mit jeder Kopie Ihrer Software.
- Marken‑Konsistenz und Quell‑Level‑Anpassungen sind nicht verhandelbar.
Analogie: Sie kaufen den Motorblock für Ihr eigenes Auto — teuer upfront, aber Sie besitzen den Antriebsstrang und können so weit fahren, wie Sie möchten.
Entscheidungsmatrix: Schnell‑Checkliste {#entscheidungsmatrix-schnell-checkliste}
| Frage | Empfohlene Lizenz | Warum |
|---|---|---|
| Wie viele verschiedene Orte wird der Viewer erscheinen? | Developer → 1‑2 Orte Site → 3+ Orte | Site‑Lizenz entfernt Instanz‑Beschränkungen. |
| Müssen Sie den Viewer an End‑User ausliefern? | SDK | Unbegrenzte Distribution und White‑Labeling. |
| Benötigen Sie Branding‑ oder Quellcode‑Zugriff? | SDK | Voller Quellcode‑Zugriff und Markenentfernung. |
| Welches Kostenmodell bevorzugen Sie? | Developer → jährliche Lizenz pro Sitz Site → jährliche Lizenz pro Site SDK → einmaliger Kapitalaufwand | Passt zur Budget‑Rhythmik. |
Tipp: Halten Sie diese Matrix in einem Projekt‑Brief oder Sprint‑Planungs‑Dokument bereit; sie deckt schnell die passende Lizenz auf, ohne lange Diskussionen mit dem Vertrieb.
Abschließende Gedanken & nächste Schritte {#abschliessende-gedanken-naechste-schritte}
Die richtige .NET‑Viewer‑Lizenz zu wählen, ist keine „One‑Size‑Fits‑All“-Entscheidung. Sie beruht auf drei Säulen:
- Umfang der Bereitstellung – einzelne App vs. mehrere Portale vs. Produkt‑Integration.
- Vertriebs‑Anforderungen – nur interner Gebrauch oder gebündelt mit einem kommerziellen Angebot.
- Budget‑Rhythmus – wiederkehrende Jahresausgaben vs. einmalige Kapitalinvestition.
Indem Sie den Workflow Ihres Teams, das Wachstumstempo und die finanziellen Vorgaben mit den oben aufgeführten Merkmalen abstimmen, können Sie teure Lizenz‑Upgrades später vermeiden und die Dokumentation reibungslos am Laufen halten.
Bereit, die passende Lizenz zu sichern?
- Besuchen Sie doconut.com/pricing und nutzen Sie den interaktiven Selektor.
- Laden Sie das License Selector Worksheet herunter, um Ihre Antworten aus der Entscheidungsmatrix zuzuordnen.
- Wenn Sie tiefer einsteigen möchten, vereinbaren Sie ein 15‑minütiges Design‑Gespräch mit unseren Solutions Engineers für eine Live‑Demo zu kollaborativem Editieren, API‑Spec‑Rendering und Git‑Sync.
Viel Erfolg beim Dokumentieren – und mögen Ihre APIs so gut versorgt sein wie Ihre Lizenz!