Je me permets de rajouter mes 2cs de non-initié au projet à la discussion sur le README.
Si celui contient énormément d'informations (gros +1 pour ça, c'est ultra agréable), j'ai personnellement ressenti un manque de structure au bout d'un moment.

Renforcer la structure ce document permettrait d'avoir

un meilleur aperçu des ressources et outils utilisés, ce qui permet une gestion plus efficace dans le temps.
d'abaisser la barrière d'entrée (enfin vu là où elle est on va dire la supprimer même) ce qui facilitera sans doute le travail lors d'initiatives comme celles proposés dans Traduire de la documentation à l'école #986.

Par exemple : de nombreux outils sont évoqués à différents endroits du document (powrap est mentionné au début au milieu des commandes Git, puis on en retrouve après le glossaire) sans que l'on sache nécessairement quels sont leurs intérêts respectifs.
Il serait également intéressant de mentionner pogrep (but de l'issue) ainsi que padpo qui sont utilisés en pratique, mais pas mentionnés.

Le partie sur la touche de composition et les caractères spéciaux occupe une grosse partie du document. Cette partie pourrait être réduite en 1) expliquant d'abord la touche de composition et comment la définir puis 2) mentionner les caractères propres au français. Comme la touche de composition est déjà évoqué en premier lieu, la deuxième partie prendrait beaucoup moins de place.

Peut-être qu'il pourrait être intéressant de créer un fichier CONTRIBUTION.md qui reprend les éléments propres à la contribution et garder dans le README.md uniquement les informations génériques. Soit la répartition qui se rapprocherait de :

README.md :

Historique du projet
Guide sur comment contribuer (quelques informations génériques puis lien vers CONTRIBUTION.md)
Accord de contribution à la documentation

CONTRIBUTION.md

Contribuer en utilisant Github : pas à pas
Que traduire
Les outils utiles pour traduire (les indispensables, les moins indispensables)
Saisir du français valide : touche de composition
- Les caractères auxquels il faut prêter attention.
Ressources utiles
Glossaire

Un truc dans ces eaux là quoi.

Uh oh!

mentionner pogrep dans le README #1021

Description

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions