Écriture académique

Comment écrire un rapport, un article de recherche, un article mathématique ou une preuve qui respecte les conventions académiques et coûte au lecteur le moins possible.

Ce dépôt étend reader-ergonomics. Les principes, leurs niveaux de preuve et les vérifications y vivent et ne sont pas répétés ici. Ce dépôt n'ajoute que ce qui est propre à ces genres : leurs preuves et les formes de leurs documents. Quand une convention académique et un principe du standard divergent, la forme dit lequel l'emporte, et pourquoi.

Le prendre

Copiez le squelette d'une forme (le bloc sous son titre « Skeleton » dans shapes/) dans un fichier à vous, et vérifiez-le avec la version du standard que ce dépôt épingle. Les vérifications lisent le Markdown ; la version .tex de chaque forme a les mêmes parties pour écrire en LaTeX, que les vérifications ne lisent pas.

git clone https://github.com/Tewf/reader-ergonomics-academic academic
git clone https://github.com/Tewf/reader-ergonomics
git -C reader-ergonomics checkout $(grep -m1 -o '[0-9a-f]\{40\}' academic/.github/workflows/checks.yml)   # la version que ce dépôt épingle
mkdir -p mon-rapport/checks    # puis collez un squelette dans mon-rapport/rapport.md
printf 'extends = "reader-ergonomics"\n[readable_measure]\nstylesheets = []\n[sufficient_contrast]\nstylesheets = []\n' > mon-rapport/checks/config.toml
python3 reader-ergonomics/checks/run.py mon-rapport

Corrigez chaque erreur, corrigez ou expliquez chaque avertissement, et répondez aux questions de mon-rapport/checks/out/needs-judgment.md. Pour faire vôtres ces formes, ou pour contester une règle, suivez la section Take your own version de reader-ergonomics : un style de lecteur, une extension ou une issue, selon l'objet du désaccord.

État : version 1.0.0, publiée le 2026-10-29. Trois revues multivocales sont écrites et auditées dans evidence/ : les articles de recherche et l'écriture mathématique, auditées le 2026-10-28, et les rapports. Chacune des quatre formes a un squelette, une version LaTeX et un exemple rédigé ; la forme d'un rapport est une première version. C'est une lecture informelle de la recherche et de la pratique publiées : pas un standard officiel, pas une étude relue par des pairs, pas un résultat nouveau, et pas une prétention à l'état de l'art.

Comment il est fait : avec Claude, un assistant IA d'Anthropic, sous la direction du mainteneur, comme reader-ergonomics. Des agents IA rédigent les revues de littérature ; chaque référence est résolue par programme, et un chiffre lu seulement dans un résumé est marqué « (secondary) ». Les corrections sont bienvenues en issues.

Portée

Quatre sortes de documents, chacune avec ses preuves et sa forme ; les sortes de rapport, du projet de cours au mémoire, sont définies dans le cadre de la revue sur les rapports :

L'écriture académique prend ici quatre formes : le rapport (projet de cours, stage, mémoire de master, rapport technique), l'article de recherche, l'article mathématique et la preuve.

Source Graphviz

// The kinds of l&#39;écriture académique this repository gives a shape to: the figure of README.fr.md.
digraph scope {
  graph [rankdir=TB, nodesep=0.4, ranksep=0.5, bgcolor="white", pad=0.2, fontname="Inter"];
  node  [shape=box, style="rounded,filled", fontname="Inter", fontsize=13, margin="0.2,0.1", penwidth=1.5, fontcolor="#1F2328"];
  edge  [fontname="Inter", fontsize=11, color="#3D434B", fontcolor="#55575F", penwidth=1.3, arrowsize=0.8];
  AW [label=<<b>l&#39;écriture académique</b>>, fillcolor="#FFFFFF", color="#3D434B"];
  RP [label=<<b>le rapport</b><br/><font point-size="11" color="#55575F">projet de cours, stage,</font><br/><font point-size="11" color="#55575F">mémoire de master, rapport technique</font>>, fillcolor="#E6F2EA", color="#2E7D4F"];
  PA [label=<<b>l&#39;article de recherche</b>>, fillcolor="#E6F2EA", color="#2E7D4F"];
  MA [label=<<b>l&#39;article mathématique</b>>, fillcolor="#E6F2EA", color="#2E7D4F"];
  PF [label=<<b>la preuve</b>>, fillcolor="#E6F2EA", color="#2E7D4F"];
  AW -> RP;
  AW -> PA;
  AW -> MA;
  AW -> PF;
  {rank=same; RP; PA; MA; PF}
}

Contenu

Partie	Contient	État
standard.md	la fiche : comment utiliser ce standard, et quelle forme pour quel document	écrit
AGENTS.md	comment modifier ce dépôt, pour une personne ou un modèle de langage	écrit
evidence/	trois revues : les articles de recherche, l'écriture mathématique, et les rapports (ligne suivante)	écrites, auditées
evidence/reports/	le rapport comme genre : ses normes, ses lecteurs et ses examinateurs, et les conflits entre la convention académique et le standard	écrite, auditée ; une seconde passe sur les examinateurs en cours d'intégration
shapes/	les squelettes d'un article de recherche, d'un article mathématique et d'une preuve, chacun avec un exemple rédigé	écrits
shapes/academic-report	un gabarit pour les quatre sortes de rapport, titres en français et en anglais	première version, avec un exemple rédigé de rapport technique ; sa structure a été essayée une fois sur un rapport de projet de cours privé, non publié ici

Les présentations sont nées ici et ont rejoint un dépôt à elles, reader-ergonomics-presentations, le 2026-10-29 : les deux revues partageaient 2 travaux sur 370.

Le vérifier

git clone https://github.com/Tewf/reader-ergonomics
python3 reader-ergonomics/checks/run.py chemin/vers/ce/dépôt

La CI exécute les mêmes vérifications à chaque push, et une exécution échoue sur toute erreur (checks.yml). Le badge en haut est le dernier résultat sur master : la preuve que ce dépôt respecte le standard qu'il étend. Chaque push sur master construit aussi le site, tewf.github.io/reader-ergonomics-academic (pages.yml).

Licence

Code sous Apache License 2.0 ; texte sous CC BY 4.0. Réutilisez-le comme vous le souhaitez, en citant ce dépôt ; CITATION.cff donne une citation si besoin.

La version anglaise, README.md, fait foi.