Improving the documentation

@LarsTH Code documentation is already generated from source code, but this is not code documentation but descriptive text, so we are using markdown here in the forum and automatically generating the web site at https://snapdocs.labix.org (for now, better URL later) with it.

About the documentation for the API, I have mentioned in the topic introducing the new documentation site a proposal for the API docs:

If you’re interested, we can try to port just one of those pages over, and then discuss the new format until we’re both happy, and then we can do all the other ones following similar guidelines.

What do you think?