I’m a big fan of The Daily Grind and a post from Friday Mike linked to this blog post which talks about Microsoft adding wiki like support to MSDN online documentation. I’m hoping that moving towards online documentation that supports some level of community contributions is an area in which CodeGear can distinguish itself.
Back when I was in QA I wrote several automated GUI test suites to test Delphi documentation including all IDE dialogs as well as all properties, methods and events for the VCL/RTL. The suite launched the help (then WinHelp), selected all of the content then copy it to the clipboard so it could further verify that the expected content was retrieved. The test covered properties, methods and events (PME’s) by parsing the Pascal source code, using a Pascal based parser originally written by $g(Anders Hejlsberg), and keying each PME into the code editor and pressing F1. The test would then search for the declaration of the PME in the help and compare it to what the parser had found to verify that the correct page appeared and that the declaration matched.
I worked closely with a few of the doc writers and in particular Janet Delu, to keep the test running and log failures. Janet was particularly interested in VCL/RTL framework coverage did a great job filling the voids that existed. When I see people today longing for old Delphi content I think of all the work she and numerous other writers did to improve our documentation. Unfortunately, much of their effort was “lost in translation” when the doc team’s management changed and the entire team turned over.
These days there is a great deal of focus on improving our documentation and everyone’s aware it’s a critical issue. Fortunately, documentation was identified early on during the preparation for the divestiture as needing attention and numerous positions where opened and the rebuilding process begun. In fact, I have a meeting on Monday with a new writer to go over some VCL documentation.
Fixing the documentation won’t happen overnight though it’s one area among many where I see CodeGear having a huge affect.