Update base.rst

Updated some function descriptions, corrected a typo, added some missing returned types and changed some examples for better formating.