fix doc, clean-up some TODOs that are now open issues