better docs
add math notes