Update documentation

in particular before every new release (estimate 2 d)

• update the readme
• Write the version 2 documentation
• Add support of multiple documentation per version or tags (to keep older version of documentation as well, not just the latest one)