In late 2017 I was asked to write a strategy on how to manage and produce support documentation for the University of Warwick’s web publishing team, which develops web and mobile applications in-house.
The number of web applications had increased since I joined Warwick in 2012. Help pages were in large banks of FAQs (frequently asked questions). Over time, they had become difficult to navigate and keep up to date. After a successful trial to incorporate documentation work with the development cycle for one application during 2016-17, there was a successful model to follow. The challenge was to identify the scope of documentation work in total and how to scale up the trial to a full service of 17 applications.
I moved this blog from WordPress to Hugo in December 2017 to learn about static site generators and to practise maintaining a site using modern processes like Git. I chose the Future Imperfect theme as a foundation and put my own styles in
add-on.css, which takes precedence over the theme’s stylesheet
The British Dyslexia Association have updated their Dyslexia Style Guide for 2018. The guide helps designers, web developers and publishers to consider the difficulties dyslexic readers experience and to improve the readability of written content. By following the principles in this guide you can improve the reading experience for everyone, not just those with dyslexia.
Hugo’s default RSS template publishes an unlimited number of items and shows a summary rather than full content. Also, the feed URL and the content Hugo generates vary depending on the active page’s content type – post, page, section, category or tag.