Fixed doc generation

Author: Sylvain MARIE

ci_tools/requirements-pip.txt

@@ -17,5 +17,5 @@ pytest-steps
 pytest-cov==2.6.0  # after 2.6.1 it requires pytest 3.6
 
 # --- to generate the doc (see .travis)
-mkdocs-material==2.7.3
-mkdocs==0.17.3  # this is to prevent a version non-compliant with mkdocs-material to be installed.
+mkdocs-material  # ==2.7.3
+mkdocs  # ==0.17.3  # this is to prevent a version non-compliant with mkdocs-material to be installed.

docs/mkdocs.yml

@@ -3,7 +3,7 @@ site_name: pytest_cases
 repo_url: https://github.com/smarie/python-pytest-cases
 docs_dir: .
 site_dir: ../site
-pages:
+nav:
     - Home: index.md
     - Usage details:
         - Overview: usage.md

docs/usage/basics.md

@@ -1,6 +1,6 @@
 # Usage basics
 
-This page assumes that you have read the [initial example](../index.html#usage).
+This page assumes that you have read the [initial example](../#usage).
 
 ## Customizing case names