python-docs-fr/README.rst

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

|build| |progression|

.. |build| image:: https://travis-ci.org/python/python-docs-fr.svg?branch=3.9
   :target: https://travis-ci.org/python/python-docs-fr
   :width: 45%

.. |progression| image:: https://img.shields.io/badge/dynamic/json.svg?label=fr&query=%24.fr&url=http%3A%2F%2Fgce.zhsj.me%2Fpython/newest
   :width: 45%


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.


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

Comment contribuer
~~~~~~~~~~~~~~~~~~

Vous pouvez contribuer :

- en proposant des *pull requests* Github (solution recommandée) ;
- en envoyant un correctif à la liste `traductions <https://lists.afpy.org/mailman/listinfo/traductions>`_.

Consultez le
`guide <https://github.com/python/python-docs-fr/blob/3.9/CONTRIBUTING.rst>`_
pour apprendre les conventions à respecter.


Où obtenir de l'aide ?
~~~~~~~~~~~~~~~~~~~~~~

Le coordinateur de cette traduction est `Julien Palard <https://mdk.fr/>`_.

N'hésitez pas à poser vos questions sur le canal ``#python-fr`` sur `freenode
<https://kiwi.freenode.net/>`_ (ne nécessite pas d'inscription) ou par la
`liste de diffusion <https://lists.afpy.org/mailman/listinfo/traductions>`_ des traductions de l'AFPy.


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

Ce projet a été lancé `vers 2000
<https://julienpalard.frama.io/write-the-docs-paris-19/#/2>`_ puis
repris `vers 2012 <https://github.com/AFPy/python_doc_fr>`_ par
l'`AFPy <https://www.afpy.org/>`_. En 2017 ce projet est devenu la
traduction officielle de la documentation Python en français grâce à
la `PEP 545 <https://www.python.org/dev/peps/pep-0545/>`_. `Jules Lasne
<https://github.com/Seluj78>`_ a publié fin 2019 une `vidéo de
l'histoire du dépôt <https://youtu.be/azXmvpEJMhU>`_.