diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000000000000000000000000000000000000..eddd9b5bf4625bfa6a1379c6a2af00ef0c2a6718
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,9 @@
+ Copyright (C)  2019  Orestis Malaspinas.
+
+
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License, Version 1.3
+ or any later version published by the Free Software Foundation;
+ with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ A copy of the license can be downloaded from:
+ https://www.gnu.org/licenses/fdl.html.
diff --git a/README.md b/README.md
index a24a8f6269d81b51eefe35969439e2b8c57209c0..cdebc883c777e6c5b6b19ab5422831215ccd4401 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,79 @@
-# cours
+[![pipeline status](https://githepia.hesge.ch/orestis.malaspin/programmation_sequentielle/cours/badges/master/pipeline.svg)](https://githepia.hesge.ch/orestis.malaspin/programmation_sequentielle/cours/commits/master)
+
+# Cours de programmation séquentielle (1ère année)
+
+Ce projet contient les diapositives du cours de Programmation séquentielle pour la
+filière ITI de HEPIA. Vous pouvez accéder à la dernière version des diapositives en cliquant sur [`ce lien`](http://129.194.185.180/prog_seq_c_cours/index.html)
+
+# Production des pdf
+
+Le projet est écrit à l'aide de la librairie [`pandoc`](https://pandoc.org/installing.html) dans laquelle on peut inclure du `LaTeX`. 
+
+Afin de compiler le projet vous avez besoin des programmes suivants:
+
+## make
+
+## pandoc (v2.0 ou plus récent)
+
+Il existe un certain nombre de package pour la plupart des distributions linux et aussi pour mac OS ou windows. Consultez le site de [`pandoc`](https://pandoc.org/installing.html) pour plus d'informations concernant l'installation.
+
+## pandoc-crossref 
+
+En supposant que la [plateforme de développement Haskell](http://hackage.haskell.org/platform/) est déjà installée vous pouvez installer pandoc-crossref avec cabal:
+
+``` bash
+cabal update
+cabal install pandoc-crossref
+```
+
+Ou alors vous pouvez également installer les fichiers binaires (ici pour la version 0.3.0.1, pas forcément la plus récente)
+```bash
+mkdir pandoc-crossref
+cd pandoc-crossref
+wget https://github.com/lierdakil/pandoc-crossref/releases/download/v0.3.0.1/linux-ghc80-pandoc20.tar.gz
+tar xzvf linux-ghc80-pandoc20.tar.gz
+export PATH=`pwd`:$PATH
+```
+
+Sinon allez voir sur le [site de `pandoc-crossref`](https://github.com/lierdakil/pandoc-crossref).
+	
+## pandoc-numbering
+
+Vous avez besoin d'une installation de python 3.X, du programme `pip`, et vous pouvez faire
+
+``` bash
+pip install --user -U pip panflute pandocfilters  pandoc-numbering
+```
+
+Pour plus d'information voir le [site](https://pypi.python.org/pypi/pandoc-numbering).
+
+## Des packages latex suivant 
+
+### Pour ubuntu ou debian-like
+
+```sudo apt-get install texlive-latex-recommended lmodern texlive-fonts-recommended texlive-latex-extra texlive-fonts-extra dvipng texlive-latex-recommended texlive-lang-french```
+
+### Pour les distributions basées sur Arch Linux (Manjaro, ...)
+
+```bash
+sudo pacman -Sy texlive-bin texlive-core texlive-latexextra texlive-science texlive-fontsextra texlive-formatsextra
+```
+
+## La libraririe librsvg (pour la conversion des images svg en ... autre chose)
+
+### Pour ubuntu ou debian-like
+
+```bash
+sudo apt install librsvg2-2
+```
+
+### Pour les distributions basées sur Arch Linux (Manjaro, ...)
+
+```bash
+sudo pacman -Sy librsvg
+```
+
+## License
+
+See the [LICENSE](LICENSE.md) file for license rights and limitations (GNU Free Documentation License).