One of the little tricks I’ve implemented with OxygenXML is dynamic content filtering. Our product supports four different programming languages – Java, PHP, C++, and .NET. Rather than producing 4 separate outputs, I produce just one output and provide a content selector option in the header.
Here’s a demo in my DITA QRG site.
This is a sponsored post by Nicole Smith on the history of technical writing. I don’t often publish sponsored posts, but I think Nicole’s essay provides a brief yet informative history of the tech comm profession that is worth reading.
The Internet has revolutionised communication completely, but this is especially apparent in technical writing. How (Read more...)
A while ago, I posted a tip on adding collapsible sections to the OxygenXML webhelp output. Collapsible sections have their place, but more commonly now, users seem to prefer long pages that they can scroll. For this behavior, it’s better to add a mini-TOC near the beginning of the page that lists the sections on that (Read more...)
I attended my first Write the Docs meetup last Thursday night in downtown San Francisco. It’s interesting to compare Write the Docs with the STC. (I was downtown at an STC SF meeting just the previous month, if you recall from an earlier post.)
What are my impressions? In general, the Write the Docs (Read more...)
In Goodbye WordPress: 2014 Will Be the Year of the Flat-File CMS, Jeremiah Shoaf argues for the upcoming dominance of flat-file systems over database-driven sites such as WordPress.
I found the post extremely interesting because I’ve been moving back and forth between flat-file systems and database systems with my DITA publishing strategies. There are compelling (Read more...)