Awesome GitHub RepositoriesBidirectional Transformations

TSDoc est un standard de documentation et une spécification pour l'écriture de commentaires structurés dans le code TypeScript. Il fournit un système portable pour définir des métadonnées, des balises et des références croisées au sein du code source afin d'assurer une analyse et un rendu cohérents à travers différents outils. Le projet inclut un analyseur de commentaires de documentation qui convertit les commentaires en un arbre de syntaxe structuré et un validateur qui applique la cohérence syntaxique. Il permet la définition de balises de documentation personnalisées via des fichiers de configuration externes et prend en charge plusieurs modes de validation de syntaxe pour aider à la conformité aux spécifications. La spécification couvre un large éventail de besoins en documentation d'API, y compris le marquage des étapes de publication, la stabilité et la dépréciation. Elle prend en charge le détail des paramètres de fonction, les valeurs de retour et les types d'exception, ainsi que la gestion de la visibilité interne, de l'héritage et des références croisées entre les déclarations.