doc: revisions to base.py (3)