Add some information on documentation conventions

fixes #105

(albeit quite roughly)