tag:blogger.com,1999:blog-11565005.post6540682466667358250..comments2023-03-29T06:17:21.481-06:00Comments on The Software Life: Bad DocumentationAndrew McKinlayhttp://www.blogger.com/profile/14951795633428513769noreply@blogger.comBlogger1125tag:blogger.com,1999:blog-11565005.post-56598846069035144842007-06-08T15:34:00.000-06:002007-06-08T15:34:00.000-06:00One of the great things about hyperlinking is that...One of the great things about hyperlinking is that you can make everyone happy relatively easily: For the managers who think they're doing the right thing by demanding completeness, you have the "X field: Enter X" type documentation. But then you hyperlink the word "X" to the section that actually describes what the field means in the context of the application. <BR/><BR/>Unfortunately, to describe what the field means in context would require that the technical writer had the time to actually understand what the application does and who the target audience is. Technical writers are rarely given that luxury.Larry Reidhttps://www.blogger.com/profile/15950655805971599646noreply@blogger.com