update docstrings
add conversion module
add docs for flags