Further docs and refactorings

Now everything is prefixed 'README'