Générez la documentation technique de vos projets Godot

Magazine
Marque
GNU/Linux Magazine
Numéro
243
Mois de parution
décembre 2020
Spécialité(s)


Résumé

Découvrons comment utiliser GDScript Docs Maker pour générer automatiquement la documentation de vos projets Godot. Nous allons voir dans cet article que l’on peut simplement, à partir de notre code et de ses commentaires, avoir une documentation toujours à jour.


La documentation d’un projet est toujours une étape particulièrement délicate et rébarbative pour beaucoup de développeurs. De plus, le fait de la rédiger manuellement conduit mécaniquement à un risque grandissant, au fil des versions, d’une désynchronisation entre la documentation et le fonctionnement réel de cette application.

La solution, vous la connaissez, consiste à générer celle-ci à partir de vos sources. Ainsi au fil des évolutions, la documentation évoluera et restera toujours pertinente.

Pour ceux développant dans d’autres langages comme Java, PHP, etc., vous devez connaître javaDoc et phpDoc avec les outils associés pour générer cette documentation. Nous allons voir ici l’équivalent pour nos projets Godot.

Pour ceux utilisant un processus d’intégration continue (Gitlab CI / Jenkins, etc.), vous pouvez même inclure cette…

La suite est réservée aux abonnés. Il vous reste 96% à découvrir.
  • Accédez à tous les contenus de Connect en illimité
  • Découvrez des listes de lecture et des contenus Premium
  • Consultez les nouveaux articles en avant-première
Envie de lire la suite ? Rejoignez Connect
Je m'abonne maintenant


Article rédigé par

Par le(s) même(s) auteur(s)

Créer une PWA (Progressive Web App)

Magazine
Marque
GNU/Linux Magazine
Numéro
267
Mois de parution
janvier 2024
Spécialité(s)
Résumé

Lorsque vous souhaitez rendre disponible votre site sur mobile, vous pensez naturellement à développer une application mobile, mais savez-vous que vous avez une autre possibilité : écrire une PWA (Progressive Web App) et ainsi proposer en un clic d’installer son icône sur votre smartphone.

Créer son photobooth custom

Magazine
Marque
Hackable
Numéro
49
Mois de parution
juillet 2023
Spécialité(s)
Résumé

Vous avez peut-être déjà vu pendant un mariage ou autre événement festif un espace réservé où des personnes se prenaient automatiquement en photo via un drôle d’appareil. Cette installation de prise de photo automatique s’appelle un photobooth, et nous allons voir dans cet article comment vous pouvez facilement créer le vôtre.

Les listes de lecture

Python niveau débutant

9 article(s) - ajoutée le 01/07/2020
Vous désirez apprendre le langage Python, mais ne savez pas trop par où commencer ? Cette liste de lecture vous permettra de faire vos premiers pas en découvrant l'écosystème de Python et en écrivant de petits scripts.

Au pays des algorithmes

11 article(s) - ajoutée le 01/07/2020
La base de tout programme effectuant une tâche un tant soit peu complexe est un algorithme, une méthode permettant de manipuler des données pour obtenir un résultat attendu. Dans cette liste, vous pourrez découvrir quelques spécimens d'algorithmes.

Analyse de données en Python

10 article(s) - ajoutée le 01/07/2020
À quoi bon se targuer de posséder des pétaoctets de données si l'on est incapable d'analyser ces dernières ? Cette liste vous aidera à "faire parler" vos données.
Plus de listes de lecture