some docstring / status updates