Category Archives: documentation

Caging Knowledge

So, Apple’s recent iBooks 2 announcement has many drooling in the media.  While I applaud the attempt to make textbooks more affordable, I do not like the proprietary nature of the implementation.   Consumers are getting locked more and more … Continue reading

Posted in documentation, standards | 1 Comment

Web Service Documentation using WSDLDocTool

Update: March 3, 2013, the project in general is not being maintained any longer, however, I have a new branch called “develop” that contains a version that will build successfully from the command line. You may get that version from here: … Continue reading

Posted in documentation, open source, turmeric, web services, wsdl | 10 Comments

>Generating JavaDoc with Maven 3 and Tycho

>One of my pet peeves are projects that don’t provide some form of SDK information. Whether this be documentation on extension points or javadoc. This little peeve was irritated again when I was trying to find some information on some … Continue reading

Posted in build, documentation, eclipse, maven, tycho, xml, xsl | 2 Comments

>Flexing the Vex editor

>I’ve been doing more writing lately besides just blog posting. One of the problems I have with tools like Microsoft Office and Open Office is that it is very easy to mess up the presentation side of things. Especially when … Continue reading

Posted in css, dita, docbook, documentation, eclipse, wiki, xml | 5 Comments

>Eclipse Documentation on the Wiki

>A while ago Chris promoted the idea of single sourcing documentation from the wiki. I followed up by helping to write the Documentation Guidelines. Since then, there are a number of projects starting to use the wiki for their documentation. … Continue reading

Posted in documentation, eclipse | Leave a comment

>Standards, Documentation, Single Sourcing, and Continuous Integration

>Over the last several years I’ve had the pleasure of working with many standard organizations. Many are trying to improve their development processes to meet the membership and the communities needs sooner. However, almost all have one area that still … Continue reading

Posted in agile, docbook, documentation, standards | Leave a comment

>Cramps on Single Sourcing with Wikis

>I’ve been working on the eclipse Documentation Guidelines for Single Sourcing using the eclipse wiki. One of the things I’m discovering is that wikis are great at capturing unstructured information and styling: bold italics underline image code And for capturing … Continue reading

Posted in documentation, eclipse, wiki, xml | 7 Comments