[WIP] fill docstrings and format raises