updates to readme and intro (docs links, copy)