While it would definitely help the long term documentation purposes of something you don't plan on having to modify, my knee jerk response is that we, as an industry, already have problems getting comments and documentation updated properly when they are in text -- media and images are harder to update.