Base documentation - minor revisions

Many revisions on the base.rst. Formated and added new examples, inserted some returned types, etc.