Comment Re:Word is the wrong tool (Score 1) 90
We then have automated processes which periodically pull certain pages, strip the navigation elements and render them to PDF
The importance of keeping your distributed docs up to date, as described above, deserves emphasis. It's highly frustrating try to program to an API with an old version of the documentation.
I also agree that Word is a lousy way to produce this type of documentation. I would go further and say that it is a poor tool to use for most non-static technical documentation. It's update capabilities seem well-suited to more narrative documents but are cumbersome and confusing for technical documents.
The importance of keeping your distributed docs up to date, as described above, deserves emphasis. It's highly frustrating try to program to an API with an old version of the documentation.
I also agree that Word is a lousy way to produce this type of documentation. I would go further and say that it is a poor tool to use for most non-static technical documentation. It's update capabilities seem well-suited to more narrative documents but are cumbersome and confusing for technical documents.