We should more closely match the README sections and documentation to the ones we have just updated in Antora.