By Eric Armstrong on Jan 15, 2009
There are many reasons to like Ruby. String interpolation and "here docs" are two of them. This post shows how they would improve JSP syntax, in particular.[Read More]
In the world of development, the need to track bug
reports and enhancement requests are a given. But they're not generally
required for documentation, in the way they are for code Quite the
reverse. For documentation, bug reports and enhancement requests
provide little benefit, and generally impede progress. (Reports filed by users are an exception, but only if that is the only means they have to provide feedback.)
This post compares documentation and code, showing why bug reports and enhancement requests are so vital to the code base, and at the same time why those reasons simply do not apply to documentation.[Read More]
Subversion is WebDAV-ready. Cool! "Just enable WebDAV in Apache". Riiigght... Like it was really that simple! But even after you get it working, there are problems: DreamWeaver's synchronization mechanisms leave a lot to be desired, and XMetaL access depends on mapping a drive in Windows--a mechanism that simply doesn't work--unless you manage to get SSL working in your WebDAV server, so you can make an https connection (something I never managed to do in Apache).
If you need the collaborative aspects of a Wiki combined with DITA's modular topics and publishing capabilities, then DAISY might just be the system you need--and it's free. DAISY provides WYSIWYG editing for Wiki pages that can be combined to publish books, either in a PDF or as a single HTML page.