(PE-2291) add docstrings and precondition in core
touch up docstring
Merge pull request #71 from KevinCorcoran/docstrings-and-precondition

(PE-2291) add docstrings and precondition in core