I also want to keep them in the README, because I suspect many people
looking at the library won’t initially click through to the docs, but
they should definitely be in the docs too. For now I think a manual
copy+paste is okay.