Awesome GitHub RepositoriesTypeScript

Documentation.js is a multi-purpose documentation tool that parses JSDoc annotations from JavaScript and TypeScript source files to generate formatted API documentation. It functions as both a documentation generator and a JSDoc linter, scanning source code for non-standard or incorrect annotations and returning human-readable warnings to enforce documentation quality. The tool operates through a pipeline-based architecture that parses JSDoc comments into an abstract syntax tree, validates annotations against style and correctness rules, and outputs documentation through interchangeable plugi

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.