update Gihub links, minor edits to doc