improve the docs
cleanup
add diagnostic of monthly distributions