docstring cleanup - part1

• cleanup docstrings (oneliner, description, params, etc..)
• replace type FreqString by simple str

i tried to take over the text from pandas as often as possible, eg for window and min_periods..