python / python-docs-fr

Mirroir de https://git.afpy.org/AFPy/python-docs-fr
https://docs.python.org/fr/
Other
353 stars 268 forks source link

review apps #1890

Closed deronnax closed 1 year ago

deronnax commented 2 years ago

Vu qu'on build la doc à chaque commit, c'est con de la discard. Un truc qui serait top, on pourrait l'uploader genre sur un S3 et en faire un static site, et les contributeurs pourraient voir le résultat. Ça a l'air de d'être amélioré mais il y a pas si longtemps, générer la doc en local était pas évident, avec un taux de succès proche des 0% pour les primos-contributeurs.

vpoulailleau commented 2 years ago

GitHub fournit un stockage temporaire (et apparemment gratuit, mais j'ai lu en vitesse) : https://docs.github.com/en/actions/using-workflows/storing-workflow-data-as-artifacts#passing-data-between-jobs-in-a-workflow

Mais j'ai pas regardé pour un site statique (on pourrait juste stocker un zip dans ce cas).

Tu as l'air de mentionner un truc à la http://www.gregreda.com/2020/12/09/deploying-static-sites-with-github-actions/

jeanas commented 2 years ago

Sinon il y a https://docs.readthedocs.io/en/stable/pull-requests.html, clés en main a priori.

deronnax commented 2 years ago

@JulienPalard une préférence ?

JulienPalard commented 2 years ago

Vous pouvez essayer de le mettre en place via readthedocs, si ça marche c'est cool, sinon on essayera autre chose.

Sur python-docs-theme on fait comme @vpoulailleau suggère, un zip, c'est super simple à mettre en place :

https://github.com/python/python-docs-theme/blob/1201e82bc2f5e28d365428ad73fde4700b1f52f6/.github/workflows/tests.yml#L32

deronnax commented 2 years ago

Je vais avoir pas mal de temps prochainement (j'ai été licencié)(économiquement), je vais tenter de nous avoir ça pour décembre (joyeux Noël)

JulienPalard commented 1 year ago

Le repo bouge sur https://git.afpy.org/AFPy/python-docs-fr/.

Je ferme toutes les issues côté github, sens-toi libre de réouvrir côté gitea au besoin.