Minor changes to objects.py and improve docs

Improve docs and type hinting for objects.py by using typing.Optional to
denote arguments or return values that could be None. Minor changes and
refactors for some methods to improve consistency.