Want to see what kind of software docs engineers celebrate?

I see posts on LinkedIn all the time about training in writing API docs or how best to document software systems. Here in Silicon Valley, it’s the hottest sub-discipline in techcomm. In fact, API docs are so popular, they have an API Docs training class on the day before TC Camp at the end of January.

A while back, I saw a Facebook post by a software engineer in the SF bay area celebrating a website of Linux software documentation. He remarked that the docs were “excellently done,” a model for software docs everywhere to emulate. Continue reading “Want to see what kind of software docs engineers celebrate?”

XPath and XSLT for Everyone

Anyone working with XML content can benefit from learning XPath. XPath is the way that elements are identified and located inside an XML Document. Want to find the first title in your document? Or the fifth? Or the 2nd one that also has those 3 special notes following it?

Stylesheets are easier if you understand how to write an XPath expression. It just takes practice to learn how to structure the question that you use an XPath expression to answer.

Continue reading “XPath and XSLT for Everyone”

Paper or ePub?

Did you know that reading on a kindle or other electronic device isn’t the same to your brain as reading on paper?

Well, as it turns out:

Neuroscience, in fact, has revealed that humans use different parts of the brain when reading from a piece of paper or from a screen. So the more you read on screens, the more your mind shifts towards “non-linear” reading — a practice that involves things like skimming a screen or having your eyes dart around a web page. –pri.org

Continue reading “Paper or ePub?”