Updated the intro to include some info about the documentation.
Updated call comments.