Update documentation for 0.7 release

issues: fixes #1473 

In general this PR should be used to update documentation for upcoming 0.7 release
That's not true... we are free to break backwards compatibility until 1.0... So I would make this sentence a little less compromised with the user: `Although we will always try to be consistent we cannot guarantee backwards compatibility for now.` or something better spelled :wink: