Hale Doc

This PR updates the README with the markdown of the most recent HALe doc, as per the GIST