better content separation

Author: j-i-l

README.md

@@ -17,10 +17,10 @@ You can simply [use this repository as a template](https://github.com/new?templa
 
 The **actual content** of the web-based course resides under `./source/content` folder.
 There you find the content for the documentation of this template which should serve you both as 🧭 guideline and 💡 inspiration.
-The layout of the page is done in `./source/conf.py` file.
+The **layout** of the web course is defined in `./source/conf.py` file.
 <!-- include-upper -->
 
-You will find further details in the [online documentation](https://t4d-gmbh.github.io/web-course-template/).
+Head over to the [online documentation](https://t4d-gmbh.github.io/web-course-template/) for detailed instructions how to build your own web course.
 
 ## Contributing 🤝🎉
 

source/content/howto/custom_logo.md

@@ -0,0 +1,3 @@
+## Customization
+
+

source/content/howto/customizatio.md

@@ -1,10 +1,20 @@
 ```{toctree}
-:maxdepth: {% if build == "slides" %}1{% else %}2{% endif %}
+{% if build == "slides' %}
+:maxdepth: 1
+:numbered"
+{% else %}
+:maxdepth: 1
+{% endif %}
 
 howto/index
 ```
 ```{toctree}
-:maxdepth: {% if build == "slides" %}1{% else %}2{% endif %}
+{% if build == "slides' %}
+:maxdepth: 1
+:numbered"
+{% else %}
+:maxdepth: 1
+{% endif %}
 
 examples/index
 ```

source/content/index.md

@@ -3,10 +3,5 @@
 ```{include} ../README.md
 :end-before: <!-- include-upper -->
 ```
-```{toctree}
-:maxdepth: 2
-:caption: Course Template Docs
-{% if build == "slides" %}:numbered:{% endif %}
-
-content/index
+```{include} ./content/index.md
 ```