Manual and welcome documentation

I have to say I'm not 100% with the documentation, so comments are welcome.