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 »

General Data Protection Regulation – will this affect online Help?

Yesterday, I saw a presentation by Hazel Southwell on the EU’s General Data Protection Regulation (GDPR), which will be implemented on the 25th May 2018. The impact in its data privacy and protection rules seem likely to affect pretty much every website, with the threat of hefty fines for those that do not comply. Organisations providing… Read more »

Microsoft publishes its REST API Design Guidelines

Microsoft has published  its REST API Design Guidelines to the API community. According to Gareth Jones, Principal API Architect, who announced its release: “The effort got started from hearing two key points of feedback from customers: It should be easier to get started with Microsoft APIs – Developers wanted to be able to run the curl tool… Read more »

Training news

Just a quick update on some recent training-related news. We’ve scheduled some new classroom courses: Cherryleaf’s policies and procedures writing course – 11th October Advanced technical writing & new trends in technical communication training – 20th October We’re also continuing to add more courses to WriteLessons – our bundle of elearning courses for technical communicators looking to expand… Read more »

Policies and procedures writing course – 11th October

We’ve scheduled another of our policies and procedures writing course. It will be held on 11th October, in central London (WC2). 25% of the available places have been snapped up already, so book early! Cherryleaf’s policies and procedures course teaches your staff how to write clear and effective policies and procedures, in a straightforward and efficient way. It is… Read more »