You should write full docstrings with types and semantics specified.