There are many different tools and skills required for different content roles, and these requirements vary by job and over time. Writing technical documentation is a specialised role, and because of this us documenters often have to take responsibility for …
There are two big concerns government organisations have around making source code open. They want to know which subsets of the code should be kept closed and how to code in the open securely. To address these questions I’ve introduced two pieces of …
As technical writers at GDS we create technical documentation which includes instructions and supporting content for the products we build. We want to make our documentation consistent across all products, but also make it easier to work closely with our …
Technical Writer on GaaP, Jonathan Glassman, recently attended the API The Docs conference, organised by our very own technical writer community at GDS and Write the Docs. Find out what he learned...
We have a growing community of technical writers in government focused on writing documentation and guidance for technologists. Next week we’ll be holding our second mini conference this year on how to write documentation in an agile environment. The event …
You may have heard, rule number one for us at Government Digital Service (GDS) is: “always start with user needs”. We do user research. Lots of it. GOV.UK Verify recently completed their 100th round of user research, and they’re not …
As you may know we’ve recently been trying to improve how we write and display our developer documentation. We’ve done lots of user research with technical architects, developers and service managers so we have an idea of what good documentation …