added explanatory docstring text and few more tweaks