clarify README documentation and fix broken link