From the Cherryleaf Podcast: User documentation in Agile – Learning from the Lean Methodology. This is a recording from the Agile the Docs mini-conference held on the 5th December 2016, London UK. It explores the tools, processes and challenges documentarians have in an Agile development team. Sorry, the audio quality isn’t great.
Category: Technical Author
What is the minimal amount of user documentation you should write?
In researching what developers wanted to learn about writing documentation for users, the most common issue related to how much, or how little, they should write. One developer said: “I would want to know what is the minimum I should write. If you can persuade me what is the necessity of each thing I’m capturing, and… Read more »
Could we use psychometric profiling of users in User Assistance?
In the How Powerful is Facebook’s Algorithm? (The Inquiry, BBC World Service), quantitative social scientist David Stillwell revealed computers can predict our personalities based on our Facebook activity. So could we use psychometric profiling of users in User Assistance?
Staff handbook written in Word and converted to a responsive Web layout
In recent posts, we’ve been describing different ways to publish policy and procedure documents online. Here’s an example of a staff handbook that has been converted from Word to a responsive web layout. The home page provides links to the main sections in the handbook. In this example, we also changed many of the sentences… Read more »
Converting policy documents written in Word to HTML – Example
In recent posts, we’ve been describing the different ways to publish policy and procedure documents online. Often, organisations want to write their content in Microsoft Word, as staff are familiar with the application. However, they also want a very nice, and usable, online version. Here’s an example of a direct conversion from Word to HTML. Before… Read more »