Converted some comments into proper docstrings
changelog clarification