xref off the root md file to the documents on the site, add a license entry there and standalone
failure handling code: getting the numbers wrong
fix the logic to handle flexing and recovery