Build updates based on testing by Javi and other things I've noticed, including some initial docs in the readme.