generate developer and user documentation

[zbeekman]

Add more description tomorrow. See #231

[zbeekman]

so much fail.... now I don't remember what I was going to say... I'll read through #231 and try to remind myself.