expand doumentation strings; clean up dangling comments; annotate goals for completion status