Write user docs for v1.

[jettisonjoe]

We have this nice wiki feature. We should actually consider using it.

[jettisonjoe]

We should look into https://readthedocs.org/ for this.

[DanLipsitt]

We'd be happy if you start a docs/ folder :)
– @fahhem in #613

If I create a config compatible with readthedocs, will a project member create an account there and link it to this repo so the docs get built and hosted?

[fahhem]

Yup, 100% I will! I already have 2 of my personal repos on there

[fahhem]

Oh, looks like @maddychan already did that. Any chance she can add Joe and myself as owners? https://readthedocs.org/projects/openhtf/

[DanLipsitt]

I've got autogenerated doc builds working in #641. I'm using PBR and right now it seems to be interfering with protobuf builds. I'm pretty sure the solution is to move some of the config from setup.py to setup.cfg so that PBR can access it. Before I invest more in PBR, I want to see how you feel about using it. I think it has several benefits in addition to making Sphinx easier. The alternative to using it seems to be to add configuration to run sphinx-autogen automatically or to remember to run it manually whenever code changes.

[wizofe]

I am considering on using OpenHTF to test our Raspberry Pi3 based Linux "flavour"/distro and could be more than happy to offer some help with the documentation or anything around. Let me know.