Clean up and clarify documentation

Updates some of the READMEs found in the repo, and the header of the contained Dockerfiles.

I hope this makes sense, but I'd be happy to work on it more if there are any nice suggestions!

Note: you can see the rendered markdown of README.md here: https://gitlab.com/tezos/opam-repository/-/tree/arvid@more-docs