first use of meaningfull docstrings