En train de revoir un gros fichier, inc/public/class.dc.template.php, qui définit l’essentiel des balises template disponible dans Dotclear. J’y ai trouvé de la doc au pseudo-format dtd qui décrit les attributs possibles d’icelles, doc qui servait un temps à générer automatiquement la documentation […]
Mot-clé - documentation
Doxygen
J’ai passé un peu de temps à configurer la génération de la documentation complète de Clearbricks, avec doxygen, ce qui permet, comme Dotclear l’est déjà (mais il faut que je vérifie ça) de documenter toutes les méthodes et propriétés publiques de la librairie. Encore un truc que j’avais pas encore […]
Doc ou pas doc ?
J’ai commencé à inclure les documentations sources à quelques plugins (Yash, Typo et sysInfo pour l’instant) et je me pose la question de savoir si c’est opportun de distribuer celles-ci dans les archives des plugins, parce qu’avec quelques copies d’écran, elles commencent à peser lourd dans la […]
Et une de plus
Une documentation de plus, celle dédiée au plugin Typo, ça me permet de supprimer les vieilles pages de doc plus vraiment à jour ici ; et puis vu que je stocke la source de la doc avec les sources du plugin dans le même dépôt, ça me permet de la versionner aussi, cerise on ze gatal ! […]
Dash ou la doc à portée d'écran
Vu hier sur le blog de Korben une appli nommée Dash qui permet d’avoir les docs utiles sous la main et sans avoir besoin d’une connexion, d’une part, et d’autre part, qui offre un mode remote si on possède un smartphone ou une tablette. Certes l’ensemble revient assez cher (tout est relatif […]