python-docs-fr/README.rst

Traduction française de la documentation Python
===============================================

Ce projet est réalisé en collaboration avec l'`AFPy
<https://www.afpy.org>`_ (Association Francophone Python), dont le but est la
promotion du langage de développement Python dans l'ensemble des
nations francophones à travers des événements accessibles à tous comme
l'édition francophone de la PyCon, la `PyConFR
<https://pycon.fr>`_, de nombreux meetups dans plusieurs villes et le
maintien de nombreux projets communautaires pour enrichir
l'écosystème.

Contribuer à la traduction
--------------------------

Vous pouvez contribuer :

- en proposant des *pull requests* Github (solution recommandée) ;
- en remontant des erreurs et propositions d'amélioration sur
  le `forum de l'AFPy <https://discuss.afpy.org/c/traduction/>`_ ou sur la
  `liste de diffusion <https://lists.afpy.org/mailman/listinfo/traductions>`_ ;
- en devenant `membre <https://www.afpy.org/adhesions>`_ de l'AFPy ou
  `mécène <https://liberapay.com/python-docs-fr>`_ du projet.

Consultez le
`guide <https://git.afpy.org/AFPy/python-docs-fr/src/branch/3.11/CONTRIBUTING.rst>`_
pour apprendre les conventions à respecter.

Le `coordinateur <https://www.python.org/dev/peps/pep-0545/#language-team>`_ de
cette traduction est `Julien Palard (mdk) <https://mdk.fr/>`_.
Vous pouvez obtenir de l'aide sur le canal
`irc://irc.libera.chat/#python-fr <https://web.libera.chat/#python-fr>`_
(ne nécessite pas d'inscription) ou poser vos questions sur la
`liste de diffusion <https://lists.afpy.org/mailman/listinfo/traductions>`_
des traductions de l'AFPy.


Accord de contribution à la documentation
-----------------------------------------

NOTE CONCERNANT LA LICENCE POUR LES TRADUCTIONS : La documentation de Python
est maintenue grâce à un réseau mondial de bénévoles. En publiant ce projet
sur Transifex, Github, et d'autres endroits publics, et vous invitant
à participer, la PSF vous enjoint à accepter cet accord qui stipule que vous
acceptez de fournir vos améliorations à la documentation de Python ou à la
traduction de la documentation de Python pour le bénéfice de la PSF sous licence
CC0 (disponible à l'adresse
https://creativecommons.org/publicdomain/zero/1.0/legalcode). En retour, vous
pouvez demander à ce que votre contribution à la documentation soit
publiquement reconnue, et si votre traduction est acceptée par la
PSF, vous pouvez (mais vous n'êtes pas obligé) soumettre un correctif incluant
une modification appropriée dans le fichier Misc/ACKS ou TRANSLATORS. Bien que
rien dans le présent *accord de contribution* à la documentation n'oblige la PSF
à incorporer votre contribution textuelle, votre participation à la communauté
Python est bienvenue et appréciée.

En soumettant votre travail à la PSF pour inclusion dans la documentation,
vous signifiez votre acceptation de cet accord.


Historique du projet
--------------------

- vers 2000 : lancement du projet ;
- vers 2012 : `reprise <https://github.com/AFPy/python_doc_fr>`_ par l'`AFPy <https://www.afpy.org/>`_ ;
- 2016 : 15 % de la documentation traduite ;
- 2017 : le projet devient traduction officielle de la documentation Python par la `PEP 545 <https://www.python.org/dev/peps/pep-0545/>`_ ;
- 2019 : 30 % de la documentation traduite ;
- 2021 : 50 % de la documentation traduite.

.. image:: https://julienpalard.frama.io/write-the-docs-paris-19/fr_translation_percent.png
   :target: https://framagit.org/JulienPalard/write-the-docs-paris-19
   :alt: Progression de la traduction