Re: suivi des todo doc

Le 30/03/2021 à 19:51, Bruno Bergot a écrit :
> Le 30/03/2021 à 19:12, RastaPopoulos a écrit :
>> Il y a déjà un tracker "documentation" sur les tickets du core exprès pour ça 
> Tout est là https://core.spip.net/projects/spip/issues?set_filter=1&tracker_id=4

Dans mes listes synthétiques d'il y a 8 jours,
il y avait 29 lignes de doc_todo et 10 lignes de doc_done.
Vous imaginez autant de tickets dans le trac ?

Je n'ignore pas ce tracker mais je ne l'ai pas trouvé adapté
... de même, probablement, que Nicod qui a posté ici son mémo ?
ou que Peetdu qui poste un forum "penser à documenter ce nouveau filtre nomdufiltre"
sous un article de spip.net, où malheureusement il est inretrouvable ?

Créer un ticket dans trac est plus lourd et plus engageant
que juste dresser un flag aide mémoire "ce commit induit un travail sur la doc".
Notamment en raison de l'identification très éphémère qu'il faut vite renouveler
et aussi car la gestion y nécessite ensuite l'intervention ou les interventions d'un admin
pour valider la fermeture du ticket.
Or les admins sont en nombre restreints et ont déjà bien d'autres choses à faire
notamment relire et valider les nouvelles documentations et leurs modifs !

Le trac peut bien servir pour des méta-rapports de todo_doc
par exemple "Créer une doc sur les classes du framework CSS SPIP".
Car sur ce sujet il y aurait des trucs à discuter avant de s'y coller.
Mais on ne voudra pas créer un ticket pour chacun des commits
qui introduit une nouvelle classe css ou en modifie une...
Alors il faudrait rassembler en commentaires dans un meta-ticket ?
Ça marchera bien ainsi,
mais on aura pas de vision synthétique de ce qui reste à faire
et de ce qui a été fait.

Alors en l'état je vois plutôt 2 outils :
- un framacalc - solution pas encore évoquée - serait à la fois plus léger à tenir
et plus efficace pour tout ce qui nécessite juste un mémo et pas de discussion.
- ou un bugtracker dédié, avec des droits adaptés.

JL