Towards content lakes

One of the trends in both data and content management is the move away from silos. In data management circles, there is a trend towards the collection and aggregation of customer data into “data lakes”. According to Margaret Rouse, a data lake is: A storage repository that holds a vast amount of raw data in its… Read more »

Documentation as Code

Tom Johnson has written two interesting posts on his blog on the “Documentation as Code” concept: Will the docs-as-code approach scale? Review of Andrew Etter’s ebook on Modern Technical Writing Documentation as Code can be interpreted in a few ways. Tom describes it as being able to store the documentation with the code: From a… Read more »

Americanisms and Britishisms

There are user documentation projects where we are asked to write in American English instead of British English, and generally this is a pretty straightforward exercise for us. However, when I speak at conferences in the USA, delegates sometimes ask me afterwards what I meant by a particular expression. For example, I was recently asked… Read more »

Microsoft launches its new documentation site, and it’s very good

Microsoft has announced the preview release of its documentation service, https://docs.microsoft.com, which currently provides content for its Enterprise Mobility products. “We interviewed and surveyed hundreds of developers and IT Pros and sifted through your website feedback over the years on UserVoice. It was clear we needed to make a change and create a modern web experience… Read more »