https://twitter.com/leelefever/status/792866791399698433 In the olden days, every family had a record player (also known as a “turntable”), and pretty much everyone knew how to use it. However, if you look at the Customer Questions & Answers section for a turntable currently on sale on Amazon, it’s clear that many people today don’t know how a turntable works,… Read more »
Category: Technical Communication
Reviewing and Editing Technical Documents Course – Update
We’ve started work on the next course to be added to the WriteLessons bundle of online training courses – “Reviewing and Editing Technical Documents”. In this situation, we may try an experiment and release each module as it is completed, rather than publish all the modules in one go. The modules will be: revising, editing, copy… Read more »
Have Amazon, Dropbox, Microsoft and Google got their information design wrong?
On an API documentation course we ran for a client yesterday, we showed a number of developer documentation websites, including ones from Amazon, Dropbox, Google and Microsoft. One common theme the delegates noticed was these sites contained a in-page table of contents, or a set of related links, on the right hand set of the screen. You will… Read more »
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 »