Improve the README
Merge branch 'master' into f.shell-resubclass