diff --git a/doc/upstream-training/README b/doc/upstream-training/README
deleted file mode 100644
index 6684baf9..00000000
--- a/doc/upstream-training/README
+++ /dev/null
@@ -1,21 +0,0 @@
-Slides for Upstream Training
-============================
-
-The files are based on teaching material provided originally by Loic Dachary as ODP files. Converted to RST text in order to be converted by Hieroglyph in convenient html5 slides.
-
-
-Install Tox
------------
-
-Install tox using pip
-
-  $ pip install tox
-
-Build the presentation
------------------
-
-  $ tox -e upstream-slides
-
-You should be able to see the slides at the given location: training-guides/doc/upstream-training/build/slides
-
-These are HTML5 slides and should open with any modern web browser.
diff --git a/doc/upstream-training/README.rst b/doc/upstream-training/README.rst
new file mode 100644
index 00000000..3f79ab74
--- /dev/null
+++ b/doc/upstream-training/README.rst
@@ -0,0 +1,26 @@
+Slides for Upstream Training
+============================
+
+The files are based on teaching material provided originally by
+Loic Dachary as ODP files. Converted to RST text in order to be
+converted by Hieroglyph in convenient HTML5 slides.
+
+Install tox
+-----------
+
+Install tox using pip::
+
+    pip install tox
+
+Build the presentation
+----------------------
+
+Build the presention using tox::
+
+    tox -e upstream-slides
+
+You should be able to see the slides at the given
+location: ``training-guides/doc/upstream-training/build/slides``.
+
+These are HTML5 slides and should open with any modern web
+browser.