Centralise guidelines for authors

[astamm]

TODO list:

• Add guidelines for handling dependencies in Python and Julia;
• Improve explanations of the use of setup-env-ci.sh and setup-render-ci.sh files;
• Use shortcode {{< include guidelines-authors.qmd >}} in template repos to have the same guidelines propagated into the README of the templates or better, clean README content and point to the Guidelines for authors page;
• Rework “Submit” tab;
• A pass at example template contents for accuracy and to avoid saying things already said in guidelines?
• Remove “How to automatically publish the HTML of my contribution to a website?” From the FAQ ?
• Change title of first section into A step-by-step guide to submitting…
• Add link to template repos in the 3-column table.
• Add information about repository ownership transfer.

[NelleV]

• Rajouter les liens vers les templates dans la section Examples papers

[astamm]

• Pour le workflow GitHub: Pas clair quoi mettre dans setup-env-ci.sh et setup-render-ci.sh. Cf. doc https://computo.sfds.asso.fr/blog/2025/revised-github-process/. A préciser dans la documentation.

[astamm]

Choses à peut-être préciser selon Manon :

• Quand on utilise le template pour créer le repo git, pas besoin de prendre toutes les branches;
• Expliquer qu'on peut modifier le _quarto.yml pour tout ce qui est entête, abstract etc.;
• Comme il y a déjà un lockfile renv, quand on fait renv::init(), il faut choisir ce qu'on veut faire; peut-être pas évident pour les gens qui n'ont pas utilisé renv avant: documenter de choisir option 2;
• La version du build.yml est différente sur la guideline-authors et sur celle du template, celle du template a les permissions d'écriture:

permissions:
      id-token: write
      contents: write
      pages: write

• Il faut que le repo git soit public pour pouvoir utiliser GitHub pages
• Les collaborateurs doivent refaire le quarto add extension computo

[astamm]

• Explain that it is possible to use multiple languages provided that we use the knitr engine.

[astamm]

• More details in Submit your manuscript section.