remove all the placeholder TODOs for writing documentation, write it where appropriate, and just remove it where not appropriate (e.g. in tests)