'floating' docstring fixes

move module docstrings to the top of the module
convert some 'docstrings' to comments
remove useless docs