This week, the Institute of Scientific and Technical Communicators published a book, called Current Practices and Trends in Technical and Professional Communication. Cherryleaf’s Ellis Pratt is one of its co-authors. “Technical and professional communicators are experts in making complex systems and worlds understandable to those who need to access them. However, both the concepts… Read more »
Category: Technical Author
Delivering a digital strategy for Parliament – Interview with Rosie Hatton
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. Topics covered: What is Parliament? 1’56”… Read more »
Example of API documentation portal using MadCap Flare
This post follows on from our Creating an API documentation portal with MadCap Flare and Swagger/OpenAPI post. It shows screenshots of a test project we created. We used Swagger’s “petstore” example API specification as the source content. We didn’t spend any time modifying the stylesheets – these are just proofs of concept. API documentation Home page… Read more »
Creating an API documentation portal with MadCap Flare and Swagger/OpenAPI
MadCap Software has published a whitepaper called The Definitive Guide to Creating API Documentation. It covers ten best practices for writers, and it describes how you can use MadCap Flare to implement these when you are writing API documentation. In this post, we’ll look at whether we can combine automatically generated REST API reference documentation with… Read more »
Take part in the Cherryleaf 2017 European salary survey
It’s been a while since our last survey of technical communicator salaries. So we thought it was time we conducted a new one. We have contracted with QuestionPro, an independent research firm, to field your confidential survey responses. All responses will remain confidential and secure. The questions will help us learn if salary levels correlate… Read more »