flesh out docs a little

.gitignore

@@ -72,4 +72,4 @@ tools/python-fido2/*
 *.pem
 *.bin
 *.key
-
+site/

docs/contributing.md

@@ -0,0 +1 @@
+We are very open to contributions!

docs/hosting.md

@@ -0,0 +1,9 @@
+Documentation of the `master` branch is deployed to Netlify automatically.
+
+To host or develop locally:
+
+- install python3 and pip
+- `pip install mkdocs mkdocs-material`
+- `mkdocs serve` and visit [localhost:8000](http://localhost:8000).
+
+The file `runtime.txt` is necessary to tell Netlify to use Python3.

docs/index.md

@@ -1 +0,0 @@
-../README.md

docs/index.md

@@ -0,0 +1,4 @@
+Welcome to the technical documentation for [solokeyssec/solo](https://github.com/solokeyssec/solo).
+
+For now, you can read the repository `README.md`, more documentation to come!
+

docs/repo-readme.md

@@ -0,0 +1 @@
+../README.md

mkdocs.yml

@@ -4,6 +4,12 @@ site_description: 'Documentation for the SoloKeys solo software'
 repo_url: 'https://github.com/solokeyssec/solo'
 copyright: 'Copyright © 2018 SoloKeys'
 
+nav:
+    - Home: index.md
+    - README.md: repo-readme.md
+    - Contributing: contributing.md
+    - Hosting: hosting.md
+
 theme:
   name: material
   logo: 'images/logo.svg'