I like that you want to documentation to reflect todays reality - this is a good discipline (and clearly one I need to work on ;))