add correct formatting to doc-strings
add small commentary
add maintainer and homepage