Added rationale in comments next to docstring generation code