Make the documentation more discoverable

[pauldougan]

Some users are not getting much further than the README and were unaware of the architecture docs

We need to signpost things more clearly

[samcrang]

I don't think this is worth looking at given the future plans for GSP (ie we're probably not adding new users/tenants).