more doc tweaks and links to source code