Integrating feedback on final documents. 

Removing under construction warnings. Tidy up todo:: directives in source.