14 Repos
Transforming machine-readable API definitions into formatted technical reference manuals.
Distinct from Templating and Documentation: Specifically generates API reference guides from specifications rather than general documentation templates
Explore 14 awesome GitHub repositories matching part of an awesome list · API Reference Generators. Refine with filters or upvote what's useful.
Nextra is a documentation framework for Next.js that functions as an MDX static site generator. It enables the creation of structured technical documentation sites by transforming MDX files into themed static pages with built-in layout and navigation. It serves as a React-based documentation tool that allows the integration of custom React components directly into markdown content. The framework distinguishes itself through integrated full-text search and a localization system that manages multilingual content via language routing and translation selectors. It also includes an AI-powered chat
Automatically generates searchable technical references from TypeScript definitions.
api-blueprint is a markdown-based API design language and specification standard used to define the structure, behavior, and data schemas of HTTP web services. It provides a formal method for mapping HTTP methods to resources and defining payload validation rules through a machine-readable syntax. The project functions as a blueprint for creating interactive technical documentation and functional mock servers. These tools transform design specifications into human-readable guides and simulated backend environments to enable integration testing before implementation. The language covers API m
Transforms machine-readable API definitions into formatted interactive guides and technical reference manuals.
TypeDoc is a documentation generator and AST analyzer that transforms TypeScript source code and comments into structured API reference websites or data files. It functions as a static site generator that converts code symbols into a searchable web interface. The project is an extensible framework, allowing users to modify the documentation process and generator logic through a programmable plugin system and custom themes. Its capabilities include API reference generation, source code parsing, and documentation coverage validation to ensure exported members are properly described. It support
Analyzes TypeScript source code to produce structured API reference websites for functions, classes, and interfaces.
Sphinx is an extensible documentation framework and multi-format document publisher. It serves as a technical content organizer that converts reStructuredText markup and Python source code comments into structured documentation for technical projects. The system transforms a single set of markup files into multiple output formats, including HTML, LaTeX, EPUB, and Texinfo. It functions as a Python API documentation tool, extracting documentation directly from source code to maintain synchronized technical reference manuals. The framework organizes complex information into hierarchies with aut
Extracts documentation directly from code to keep technical references synchronized with the codebase.
Jazzy is a source code documentation tool and API generator designed for Swift and Objective-C. It analyzes project roots and compiled modules to produce searchable HTML websites or offline docsets. The system functions as a multi-module API documenter, aggregating documentation from separate source modules into a single site with cross-module linking. It serves as a markdown-based documentation engine that integrates technical guides and LaTeX mathematical equations to complement generated API references. The tool covers a broad capability surface including multi-language API generation for
Transforms machine-readable API definitions into formatted technical reference manuals and Dash-compatible docsets.
Doxygen is a source code documentation generator and multi-language API reference tool. It extracts annotated comments from source code to create structured technical manuals and searchable software libraries in formats including HTML, LaTeX, and PDF. The project functions as a static code analysis visualizer, generating call graphs, class diagrams, and inheritance hierarchies to illustrate codebase structure. It also serves as an XML documentation export engine, producing structured metadata that can be transformed via XSLT or third-party tools. Beyond API extraction, the tool provides a Ma
Generates lists of documented functions and methods that call or utilize a specific entity.
Rushstack ist ein umfassendes Toolset für die Verwaltung groß angelegter TypeScript-Monorepos und bietet ein Framework für Build-Pipeline-Automatisierung, Abhängigkeitskoordination und statische Analyse. Es fungiert als inkrementeller Build-Orchestrator und Managementsystem, das darauf ausgelegt ist, Konsistenz und Performance über mehrere Pakete in einem geteilten Workspace hinweg zu wahren. Das System zeichnet sich durch ein Ausführungsmodell aus, das auf gerichteten azyklischen Graphen (DAGs) und inhalts-hash-basierter Inkrementalität basiert, was sicherstellt, dass nur betroffene Projekte neu gebaut werden. Es optimiert Entwicklungs-Workflows weiter durch Remote-Build-Artifact-Caching mit Integrationen für S3, Azure und HTTP und nutzt symlink-basiertes Workspace-Management für sofortige Sichtbarkeit lokaler Änderungen. Das Toolset deckt ein breites Spektrum an Funktionen ab, einschließlich automatisierter Release-Workflows, API-Vertragsanalyse und der Durchsetzung von Code-Qualität im Unternehmen durch standardisierte Linting-Profile. Es bietet zudem umfassende Unterstützung für Asset-Bundling, TypeScript-Transpilierung und die Generierung von Typdefinitionen aus JSON-Schemas und statischen Assets. Zusätzliche Aufgabenbereiche umfassen Lokalisierungsmanagement, die Generierung von Lizenzhinweisen und die Orchestrierung von Command-Line-Interfaces mit synchronisierter Prozessausgabe.
Converts structured metadata into Markdown or DocFX format for searchable online API reference manuals.
This project is the official Kubernetes documentation website, serving as a comprehensive technical resource for managing containerized applications. It functions as an open-source technical documentation portal that provides guides, tutorials, and reference materials for distributed systems software. The site is built using a static site generator with a component-based template architecture to maintain consistent design patterns. It features an OpenAPI documentation generator that parses technical specifications to automatically build and update structured API reference pages. To support a
Implements a system to transform machine-readable API definitions into formatted technical reference manuals.
TSDoc ist ein Dokumentationsstandard und eine Spezifikation für das Schreiben strukturierter Kommentare in TypeScript-Code. Es bietet ein portables System zur Definition von Metadaten, Tags und Querverweisen innerhalb des Quellcodes, um eine konsistente Analyse und Darstellung über verschiedene Toolings hinweg zu gewährleisten. Das Projekt enthält einen Doc-Kommentar-Parser, der Kommentare in einen strukturierten Syntaxbaum umwandelt, sowie einen Validator, der die Syntaxkonsistenz erzwingt. Es ermöglicht die Definition benutzerdefinierter Dokumentations-Tags über externe Konfigurationsdateien und unterstützt mehrere Syntax-Validierungsmodi, um die Einhaltung der Spezifikation zu unterstützen. Die Spezifikation deckt eine breite Palette von API-Dokumentationsanforderungen ab, einschließlich der Kennzeichnung von Release-Stufen, Stabilität und Deprecation. Sie unterstützt die Detaillierung von Funktionsparametern, Rückgabewerten und Exception-Typen sowie die Verwaltung von interner Sichtbarkeit, Vererbung und Querverweisen zwischen Deklarationen.
Converts source code comments into searchable public documentation with cross-references and stability markers.
Knife4j ist eine erweiterte Weboberfläche zur Visualisierung und Interaktion mit OpenAPI- und Swagger-Spezifikationen. Sie dient als Dokumentations-UI und Debugging-Tool, das automatisch technische Referenzen aus Java-Quellcode und Web-Frameworks generiert. Das Projekt zeichnet sich durch die Fähigkeit aus, API-Definitionen aus mehreren verteilten Microservices in einem einzigen, vereinheitlichten Dokumentationsportal zu aggregieren. Es sichert dieses Portal mittels OAuth2-Authentifizierungs-Flows und bietet ein Gateway, um den Zugriff auf technische Spezifikationen und Test-Tools einzuschränken. Die Plattform umfasst Funktionen für das Request-Debugging mit dynamischem Parametertest und Proxy-basiertem Request-Forwarding. Sie unterstützt zudem das Content-Management durch die Integration externer Markdown-Dateien für ergänzende technische Leitfäden und bietet Tools zur Anpassung der Frontend-Oberfläche.
Integrates with web frameworks to automatically produce structured API references for developers directly from source code.
Appledoc ist ein Objective-C-Dokumentationsgenerator und Static Site Generator, der Quellcode-Kommentare parst, um strukturierte HTML-Dokumentationssets zu erstellen. Sein Hauptzweck ist die Generierung professioneller Entwickler-Referenzhandbücher, die den offiziellen Apple-Dokumentationsstilen entsprechen. Das Tool zeichnet sich dadurch aus, dass es sich direkt in den Projekt-Kompilierungsprozess mittels automatisierter Build-Phase-Skripte integriert und so sicherstellt, dass technische Handbücher bei Codeänderungen aktualisiert werden. Es bietet umfangreiche Anpassungsmöglichkeiten durch externe HTML- und CSS-Vorlagen sowie ein Property-List-Konfigurationssystem zur Verwaltung globaler Einstellungen und dynamischer Laufzeit-Pfad-Auflösung. Das Projekt deckt ein breites Spektrum an Funktionen ab, einschließlich Quellcode-Analyse zur Extraktion von API-Member-Signaturen und Organisation von Methoden in strukturierte Abschnitte. Es bietet automatische Querverweise zwischen Klassen und Protokollen, die Möglichkeit, externe statische Inhalte oder Markdown in den Hauptindex zu importieren, sowie die Generierung indizierter Dokumentationssets speziell für integrierte Entwicklungsumgebungen (IDEs). Das System enthält zudem Dienstprogramme für die Veröffentlichung von Dokumentationsversionen mittels Archivdateien und die Aktualisierung von Atom-Feeds sowie Debugging-Tools zur Verifizierung des finalen aufgelösten Zustands der Konfigurationseinstellungen.
Creates indexed cross-references and navigational links between classes, protocols, and methods within a codebase.
Compodoc ist ein TypeScript-API-Dokumentationsgenerator, Static-Site-Generator und Visualisierungstool für Projektarchitekturen. Es analysiert Quellcode und JSDoc-Kommentare, um durchsuchbare technische Referenzseiten, API-Kataloge und eigenständige HTML-Seiten zu erstellen. Das Projekt zeichnet sich durch die Analyse von Import-Statements aus, um Abhängigkeitsgraphen und Modulkarten zu erstellen, die die strukturellen Beziehungen innerhalb einer Codebasis veranschaulichen. Es bietet spezialisierte Unterstützung für die Visualisierung von Angular-Projekten, NestJS-Workflows und Stencil-Webkomponenten und kann funktionierende Live-Demos direkt in Dokumentationsseiten einbetten. Das System fungiert zudem als Analysetool für die Dokumentationsabdeckung, liefert Berichte und erzwingt Mindest-Coverage-Schwellenwerte innerhalb von CI-Pipelines, um Builds bei unzureichender Dokumentation fehlschlagen zu lassen. Weitere Funktionen umfassen Markdown-Integration, Datenexport in JSON oder Markdown sowie einen lokalen Entwicklungsserver mit Dateisystem-Monitoring für automatische Rebuilds. Nutzer können die Ausgabe über Konfigurationsdateien, benutzerdefiniertes CSS-Styling und Filter für die Sichtbarkeit von Elementen anpassen, um bestimmte Symbole oder interne Tags von der finalen Seite auszuschließen.
Transforms source code and JSDoc into searchable technical reference manuals for components and classes.
hugo-book ist ein Dokumentations-Theme und Framework für statische Websites für Hugo, das darauf ausgelegt ist, strukturierte technische Handbücher, Dokumentationsbücher und mehrsprachige Wissensdatenbanken zu erstellen. Es transformiert Verzeichnisstrukturen in hierarchische Navigationsmenüs und formatierte technische Inhalte. Das Framework enthält einen spezialisierten OpenAPI-Dokumentations-Renderer, der Spezifikationen in strukturierte Referenzseiten konvertiert. Es bietet zudem eine clientseitige Volltextsuche-Integration und unterstützt mehrsprachige Inhalte mit Right-to-Left-Layout-Spiegelung. Das Projekt deckt eine breite Palette an Content-Rendering-Funktionen ab, einschließlich mathematischem Formelsatz, Diagrammgenerierung, Terminal-Recording-Integration und interaktiven Elementen wie Tabbed-Panels und einklappbaren Blöcken. Es integriert zudem ein chronologisches Blog-System und Tools zur Generierung von Inhaltsverzeichnissen und Stepper-Listen. Die visuelle Anpassung erfolgt über Farbschema-Unterstützung, CSS-Style-Overrides und benutzerdefinierte HTML-Injektion.
Generates formatted technical reference manuals by transforming machine-readable OpenAPI specifications.
dumi is a static site generator and markdown-based documentation tool specifically designed for software component libraries. It transforms markdown files and source code into structured technical guides and API references. The project distinguishes itself by providing an interactive component playground that renders live, runnable code demos directly in the browser. It includes an automated API reference generator that parses source code to create documentation tables and property descriptions. Additionally, it supports a monorepo documentation workflow with source mapping and hot module rep
Parses source code to automatically create structured documentation tables and metadata for components.