improve a docstring
improve __init__ code