DOC Fix example path
DOC fix 'Return' -> 'Returns'
FIX Py3k support for out-of-core example
DOC add links to github sourcecode in API reference