In the Agile Technical Writers forum on LinkedIn, one of its members posted this question: “I need to create an contextual online help for an complex web tool (ok, that´s not that hard). The customer must be able to add some specific job instructions to this online help by himself. The customer part must not be overridden when the… Read more »
Category: UGC
Stack Overflow is moving into documentation (get the popcorn)
Stack Overflow, a collaboratively edited question and answer site for programmers, has announced its plans to add documentation to the site: “Lately we’ve been asking ourselves “what else could we do to improve developers’ lives on the internet?”. Jeff’s original announcement of Stack Overflow said this: There’s far too much great programming information trapped in forums,… Read more »
Content as an API – Mozilla Developer Network
Mozilla is an organisation that always seems to be doing innovative things with their documentation. One of the experimental functions it has introduced to its Kuma wiki platform for the Mozilla Developer Network (MDN) documentation is an experimental PUT API that makes it possible to create and update articles remotely. Mozilla suggests a number of ways it can be… Read more »
Atlassian no longer lets users comment on its documentation – good or bad news?
Last week, Atlassian sent out this message on Twitter: We’re changing our documentation platform, including closing comments. Read more and learn why http://t.co/PjZVCV1Vze — Atlassian (@Atlassian) April 14, 2015 This was a surprise, as Atlassian has been a strong advocate for having user comments appended to user documentation. Sarah Maddox, when she was working at… Read more »
Changing times in technical communication 2 – Workflow
We’ve been on the road in recent days and weeks, visiting different documentation teams, and we’ve found there are distinct signs of change. In this post, I’ll look at how we’re starting to see the workflow for creating User Assistance beginning to change. We found many documentation teams overstretched and starting to be asked how… Read more »