Add a link to the documentation to the README

Fixes #330.
Fix-up merge of e0a583
Fix up merge of 7dbb70ef70a1a11bf5d5
fix creation of directories
fix open mode
update changelog --- cherry-pick bd8be5d60f8