Refactor front pages

README.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 scikit-image tutorials
 ======================
 

_config.yml

@@ -6,8 +6,6 @@ exclude_patterns:
     - '*/not_yet_booked/*'
     - '*/solutions/*'
     - '*/_build/*'
-    - README.md
-    - index.md
 execute:
     execute_notebooks : 'cache'
     timeout: 180

_toc.yml

@@ -1,6 +1,7 @@
 format: jb-article
-root: lectures/00_images_are_arrays
+root: index
 sections:
+- file: lectures/00_images_are_arrays
 - file: lectures/1_image_filters
 - file: lectures/3_morphological_operations
 - file: lectures/4_segmentation

index.md

@@ -0,0 +1,18 @@
+# Scikit-image tutorials
+
+These pages are a collection of tutorials for the
+[scikit-image](http://skimage.org) package.
+
+You can read the tutorials as web pages, or you can setup and run on your local
+machine:
+
+1. [Follow the preparation instructions](preparation)
+2. Start the notebook server *from the same directory as this file* with
+   `jupyter notebook`
+
+Refer to [the gallery](http://scikit-image.org/docs/dev/auto_examples/) as
+well as [scikit-image demos](https://github.com/scikit-image/skimage-demos)
+for more examples.
+
+Please see the repository [README](README) for more about the files here, and
+guidelines for use and contribution.

preparation.md

@@ -72,4 +72,9 @@ On my computer, I see (but your version numbers may differ):
 [✓] scikit-learn  0.19.1
 ```
 
-**If you do not have a working setup, please contact the instructors.**
+**If you are in a workshop, and you do not have a working setup, please contact
+the instructors.**
+
+## Next
+
+See the [guide to this repository](repo_guide).

repo_guide.md

@@ -0,0 +1,23 @@
+---
+orphan: true
+---
+
+# Once you have cloned or copied the lectures
+
+See [preparation](preparation) to get the lecture files on your own computer.
+
+The instructions here are to guide you once you have done that.
+
+## Lectures
+
+See the full list of lectures in the `./lectures` directory.
+
+## Events
+
+Workshop teaching schedules are in the `./workshops` directory.
+
+## More demos and examples
+
+Refer to [the gallery](http://scikit-image.org/docs/dev/auto_examples/) as
+well as [scikit-image demos](https://github.com/scikit-image/skimage-demos)
+for more examples.