Pulp...er, help fiction
Pilot fish gets bored with writing documentation for this computer-aided design software vendor, so he volunteers for the team working on a new product.
"There were a dozen developers and me," says fish. "My job was to build and write the help system. It was, um, a joy from the start. With no tools available, I had to build the entire JSP system in Emacs."
But that's not the worst of it. The developers are working furiously to get the coding for new functionality done, and fish receives no notes from project leads, no design specs, no emails from developers and barely any review from QA. The only hints fish gets as to what should be in the docs come from what he can glean from the developer meetings.
To read this article in full or to leave a comment, please click here