Fixes and minor additions to the docs.
merged branch javiereguiluz/doc_fixes (PR #982)

This PR was merged into the master branch.

Commits
-------

aac6cb6 Fixes and minor additions to the docs.

Discussion
----------

Fixes and minor additions to the docs.
removed list of built-in items in the docs in favor of a link (easier to maintain and better for discoverability)