Skip to main content
GOV.UK
Blog Technology in government
Organisations:
Civil Service

Build your Docs career: Come and join us in June 2018

Posted by: Jonathan Glassman, GDS Technical writer, Posted on: 3 May 2018 - Categories: Jobs
Laptop and notes at a lectern

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 …

Read more of Build your Docs career: Come and join us in June 2018

Don’t be afraid to code in the open: here’s how to do it securely

Posted by: Anna Shipman, Posted on: 27 September 2017 - Categories: Open Source

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 …

Read more of Don’t be afraid to code in the open: here’s how to do it securely

Why we use a ‘docs as code’ approach for technical documentation

Posted by: Jen Lambourne, Posted on: 25 August 2017 - Categories: Tools, Transformation

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 …

Read more of Why we use a ‘docs as code’ approach for technical documentation

API the Docs conference: 3 key takeaways

Posted by: Jonathan Glassman, GDS Technical writer, Posted on: 24 July 2017 - Categories: Tools
API-the-Docs-conference-Rosalie

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...

Read more of API the Docs conference: 3 key takeaways

A mini conference for technical writers on agile documentation

Posted by: Rosalie Marshall, Posted on: 29 November 2016 - Categories: Chat

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 …

Read more of A mini conference for technical writers on agile documentation - 5 comments

Writing documentation for developers

Posted by: Catherine Heywood, Posted on: 28 October 2016 - Categories: Chat, GaaP, GOV.UK Verify

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 …

Read more of Writing documentation for developers

Assessing documentation tools for GOV.UK Pay

Posted by: Paulo Monteiro, Posted on: 20 May 2016 - Categories: GaaP, Tools

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 …

Read more of Assessing documentation tools for GOV.UK Pay - 7 comments
Previous page
  • Page 1
  • Page 2

Related content and links

Technology in government

This is for everyone: documenting how we're building, assembling and running digital and technology projects across the UK government. Find out more.

Categories

Work with us

A sticky note reads "Everybody helps to fix the build".

If you’re interested in jobs in this field, check out all open opportunities on the GDS careers site.

Sign up and manage updates

  • Email
  • Atom

Find out more

Join the conversation

Recent Posts

  • Agile, secure and cost-effective: UKEF’s open source API shift 14 July 2025
  • From Westminster to York: Reflections on Building a Modern Digital Government 25 June 2025
  • Improving public sector spending with the cloud cost data solution 17 June 2025

Comments and moderation

Read our guidelines

Useful links

  • All GOV.UK blogs
  • All GOV.UK blog posts
  • GOV.UK
  • All departments
  • Accessibility statement
  • Cookies
All content is available under the Open Government Licence v3.0, except where otherwise stated
© Crown copyright