Add readme

Author: maximlt

README.rst

@@ -0,0 +1,45 @@
+.. PythonScript documentation master file, created by
+   sphinx-quickstart on Wed Aug 21 20:25:15 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Tutoriel: Comment s'y prendre pour écrire des scripts en Python
+===============================================================
+
+**Python** est un langage de programmation avec lequel il est facile d'écrire
+des scripts. Ces scripts peuvent permettre d'automatiser des tâches répétées
+fréquemment à la main (envoyer des e-mails, analyser des fichiers, etc.) ou de
+développer des analyses complexes (remplacer une macro Excel).
+
+Même si **Python** est un langage relativement simple à apprendre, il n'est
+pas aisé, en partant de zéro, de trouver la manière de s'y prendre pour
+l'intégrer dans son travail. L'objectif de ce tutoriel
+est donc principalement de **proposer une méthode complète permettant
+l'écriture de scripts Python pouvant être exécutés facilement**. Le tutoriel
+s'adresse à des **débutants en programmation** qui souhaitent intégrer
+Python dans leur méthode de travail.
+
+Les informations fournies dans le tutoriel sont adaptées à la configuration 
+suivante:
+
+* Système d'exploitation (OS): **Windows** [7/10]
+* Gestionnaire de packages et d'environnement: **Conda** [>=4.7]
+* Environnement de développement (IDE): **Spyder** [>=4]
+* Langage: **Python 3** [CPython >=3.7]
+* Packages: **Numpy** [>=1.16], **pandas** [>=0.25], **Matplotlib** [>=3.1]
+
+**A part Windows, tous les logiciels utilisés dans le tutoriel sont
+gratuits et open-source**. Leurs auteurs et contributeurs sont remerciés
+pour l'ensemble de leur travail.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contenu du tutoriel
+
+   introduction
+   environnement
+   installation
+   python
+   utilisation
+   exercices
+

source/python.rst

@@ -2,6 +2,7 @@ Découverte de Python
 ====================
 
 Ce chapitre contient deux notebooks principaux:
+
 * Introduction pas à pas de Python
 * Numpy, pandas et Matplotlib en express
 
@@ -13,7 +14,7 @@ Elle contient plus d'explications et aborde des concepts
 supplémentaires.
 
 Les trois notebooks sont téléchargeables en scripts Python
-(``.py``) `ici <https://github.com/maximlt/PythonScript/tree/master/pyscripts>`_.
+(extension ``.py``) `ici <https://github.com/maximlt/PythonScript/tree/master/pyscripts>`_.
 Les cellules initiales des notebooks sont reproduites
 dans les fichiers ``.py``, leur début est marqué par
 le symbole ``# %%``. Lorsqu'on ouvre ces fichiers dans *Spyder*, on