preguntar acerca de documentation-generation

Il semble y avoir une pléthore d'outils de documentation pour Python. Un autre que j'ai rencontré est epydoc. Il semble que Sphinx soit le standard de facto, car il est utilisé pour générer les documents Python officiels. Quelqu'un peut-il trier l'ét …

j'ai un projet django, que j'document à l'aide de repos dans les docstrings de faire ce qui suit: Aide diagloags au sein de l'IDE plus tard pour construire la documentation HTML en utilisant Sphinx ma documentation apparaît correctement dans IDE ( …

j'ai remarqué que doxygen utilise la bibliothèque graphviz pour créer des diagrammes. Avez-vous déjà utilisé graphviz pour générer de la documentation? Vaut-il la peine d'apprendre le graphviz à des fins de documentation en dehors du cadre de doxygen …

salut à tous. Je vais essayer de faire cette brève et simple. :) j'ai 40 standard des documents word avec une série de champs (Nom, adresse, etc) qui doivent être remplis. Cela se fait traditionnellement manuellement, mais c'est répétitif et encomb …

est-il possible de créer des alias des types scalaires de protobuf? par exemple, je voudrais utiliser Sequence au lieu de string , même s'ils seraient équivalents binaires. mon objectif immédiat est de rendre la documentation (généré …

quand je génère de la documentation Doxygen en format PDF, je reçois beaucoup de fichiers différents avec un seul diagramme dans chaque. Est-il possible d'obtenir un seul document PDF, organisé comme un livre, en gros comme la version HTML? …

j'ai besoin de mettre en œuvre une solution de génération de documentation pour mon lieu de travail et je l'ai réduit aux trois mentionnés dans le titre. J'ai été en mesure de trouver très peu d'information sur la façon de faire des comparaisons offi …

J'utilise du Doxygen avec une source en C. Étant donné un .C./h paire de fichier, mettez-vous Doxygen commentaires sur le prototype de fonction (.h file) ou la définition de la fonction (.C file), ou les dupliquez-vous aux deux endroits? J'a …

est-ce que quelqu'un connaît un bon outil pour générer de la documentation Google Protobuf en utilisant le .proto fichiers sources? ... …

je travaille sur le code Matlab partagé et nous aimerions partager une documentation générée comme documents HTML consultables dans notre réseau local. je connais les méthodes suivantes pour générer une documentation: Écrire un c …