In this episode of the Cherryleaf Podcast, we talk to Terry Hopper of Middlestone about modelling business processes, process mapping, the relationship between processes and procedures, and Business Process Model and Notation (BPNM).
Here is early access to the latest episode on the Cherryleaf Podcast – Interview with Anne Gentle, author of Docs Like Code and Product Manager at Cisco. It will be published on the podcast channel on Monday.
- What is docs as code?
- Why do it?
- When might this approach might be applicable?
- The limitations
- Docs like code in development sprints
- Is it only for developer docs?
- Do you you need to understand programming?
- Why did you self publish?
- The benefits of taking this approach
- The future developments
- Automating document builds
Links to topics mentioned:
http://codewerdz.org/ Repository analytics for code and docs
Solr (Search Engine)
Why we use a ‘docs as code’ approach for technical documentation Jen Lambourne, GDS, GOV.UK
Below is an interview with David Farbey of the Institute of Scientific and Technical Communicators, where we discuss training, accreditation and CPD in technical communication.
- Becoming a technical communicator is different from becoming a lawyer, doctor, developer or an accountant in that, in the UK, there is no standard career path from school. How does that affect the profession and starting a career?
- What training, if any, do you need to be a technical communicator?
- The ISTC’s Professional Development and Recognition
- Certifying technical communicators
- The ISTC certified courses
- What does a undergraduate or post-graduate course offer someone?
- Where does CPD fit into this?
- What are we likely to see in the future with regards to training and certification?
See also: Cherryleaf’s ISTC accredited training course: https://www.cherryleaf.com/training/technical-author-basicinduction-training-course/
From the Cherryleaf podcast: The UK Parliament is one of the oldest organisations in the world. So how do you deliver a strategy to a body that has over 700 years of content? Cherryleaf’s Ellis Pratt interviewed Rosie Hatton, Strategy Digital Lead at the Parliamentary Digital Service, to find out.
- What is Parliament? 1’56”
- The content Parliament creates. 3’38”
- What is the PDS? 5’08”
- The I AM PARLIAMENT programme. 9’00”
- The PDS’s digital strategy framework, its assumptions and principles. 10’18”
- Having an open and agile digital culture in a traditional organisation. 13’08
- Working in a continuous interative process. 20’45”
- Sharing ideas with the Government Digital Service. 25’24”
- Where does the PDS’s content strategy fit within its digital strategy? 28’22”
- Tracking the impact of changes to laws on other laws. 37’01”
- The similarities between PDS and Open Source software projects. 41’55”
- Crowdsourcing a digital strategy. 43’30”
- Benefits management. 44’00”
- How to manage and sell change. 47’50”
- Parliamentary Digital Service blog
- https://khub.net/ (knowledge hub)
Here is an interview we carried out with Mark Baker, author of Every Page is Page One. The interview is interspersed with audio snippets from Day 1 of the UAEurope 2017 conference.
- Caroline Loverage (Thermo Fisher Scientific). Teaching by Example: Worked Examples in the Documentation of Complex Systems
- Kelly O’Brien (Kayako). Practical Information Architecture: Building Templates For Better Content.
- Helena Pichler (Nominet). AsciiDoc to Responsive Webhelp: Agile documentation for small teams/
With thanks to Matthew Ellison and Mark Baker.
I was asked to take part in the ContentHug series of interviews on technical communication and content strategy.
— Vinish Garg (@vingar) September 21, 2015
It was fun and challenging, going through the questions.
ContentHug’s Vinish Garg is interviewing a number of consultants involved in technical communication and content strategy, and asking them essentially the same questions. By reading the interviews, you can see where there are areas of agreement and where there are a variety of opinions. In general, there is a fair bit of consensus. They are worth reading.
Here’s the latest Interview, with John McNamara of IBM, on what it’s like to be a technical communicator:
Here’s our Interview with Diana Logan MISTC of Citrix Systems, on what it’s like to be a technical communicator.