J'ai plusieurs fois commenté des articles de la série 10 simple rules de la revue PLOS Computational Biology. Un nouvel article a été publié le 28 septembre 2017 avec le titre 10 simple rules for structuring papers. Les 10 règles proposées sont :
-
Focus your paper on a central contribution, which you communicate in the title
-
Write for flesh-and-blood human beings who do not know your work
-
Stick to the context-content-conclusion (C-C-C) scheme
-
Optimize your logical flow by avoiding zig-zag and using parallelism
-
Tell a complete story in the abstract
-
Communicate why the paper matters in the introduction
-
Deliver the results as a sequence of statements, supported by figures, that connect logically to support the central contribution
-
Discuss how the gap was filled, the limitations of the interpretation, and the relevance to the field
-
Allocate time where it matters: Title, abstract, figures, and outlining
-
Get feedback to reduce, reuse, and recycle the story
L'article est intéressant, mais la théorie ne suffit pas pour écrire. Ces 10 règles sont sensées, et méritent lecture. D'autres règles peuvent être suggérées : KISS (Keep It Short & SImple), n'écirvez que pour 3 personnes (rédacteur en chef et 2 reviewers), focalisez sur les méthodes (oublié dans l'article), …
