update docs and remove old TODOs
fix formatting