Skip to main content
Ocado Careers

Senior Technical Writer- API

Hatfield, UK

Senior Technical Writer- API | Hatfield | Hybrid (2 days office) 

About us

Our teams are putting the world’s retailers online using the cloud, robotics, AI, and IoT. We provide services to partner clients globally via our innovative advanced robotics technology, known as the Ocado Smart Platform ("OSP"), this drives our highly automated, multi-million pound Customer Fulfilment Centres (CFCs). In our CFCs - together with the proprietary software applications - we operate a world-class online grocery business that automates the single pick of products, ready for your online delivery.

About the role 

We’re looking for an experienced Senior Technical Writer, with a specialism in writing API and developer documentation, to create content for our developer portal. Our integration layer is growing rapidly, and so is our need for first-class documentation to go with it. We need someone who has a thirst for understanding how things work and has a thorough understanding of REST APIs and webhooks, and can use those skills to write easy-to-use documentation that creates a great developer experience. You’ll be involved in API, webhook, and data feed development from design through to release, working directly with software engineers and product managers. You’ll do this while being part of a technical writing team within your business stream, which provides the support, guidance and, education needed to perform the role, and also a wider Technical Communications department.


What you will do

As a Senior Technical Writer for developer documentation you will:

  • Produce clear, easy-to-read, and consistent documentation for our APIs, webhooks and data feeds predominantly.

  • Write references, integration guides and release notes.

  • Help engineering teams with consistent naming of attributes/fields.

  • Become a subject matter expert for the areas you work on.

  • Work closely with Product Managers, Engineers, and other Technical Writers.

  • Develop relationships with our Solution Architects.

  • Review and proofread other writers’ work.

  • Contribute to the working methods and processes of the wider Technical Communications team

We’re looking for someone who has strong technical writing experience, particularly in the API area, and is a content enthusiast - who knows the impact well-written content can have, and also who is looking to explore new ways of enhancing the experience of learning to use, and using, the software with new and emerging approaches.


We’d love to hear from you if you have:

  • Proven experience of writing API and developer-focussed documentation.

  • Proven experience in documenting cross-sectional, technical topics.

  • Proven experience in writing according to accepted industry standards.

  • A working knowledge of REST APIs and the Open API schema.

  • An understanding of the needs of developers who build against APIs.

  • Impeccable written English, and the ability to write consistently and concisely in accordance with a style guide.

  • The ability to write easy-to-read, fluent text in plain English, and the capability to organise content clearly.

  • Proven experience of working directly with engineering teams.

  • An ability to work independently to tight deadlines, across multiple projects simultaneously.

  • Using Git, or other version control systems


Bonus points if you also have…

  • Writing for internationalisation - and working with software and content that is delivered in multiple languages.

  • Using static site generators such as Jekyll, and writing in Markdown.

  • Working in an Agile environment



What we offer you...

Our employee benefits are designed for you, we care about people and we’ve ensured we have a wealth of benefits that focus on your well-being. We regularly review our benefits to ensure we are supporting our employees appropriately. Currently, we offer technically stretching work, a competitive salary and;

  • A Work from Home policy that sees you in the office typically 40% of your time. 
  • 30 days ‘working from anywhere’ policy 
  • Wellbeing support through Apps and an Employee Assistance Programme
  • 25 days annual leave, rising to 27 days after 5 years service (plus optional holiday purchase)
  • Pension scheme (various options available including employer contribution matching up to 7%)
  • Private Medical Insurance
  • 22 weeks paid maternity leave and 6 weeks paid paternity leave (once relevant service requirements complete) 
  • Train Ticket loan (interest-free)
  • Cycle to Work Scheme
  • Free shuttle bus to and from Welwyn Garden City Train Station to the Welwyn Garden City offices
  • Opportunity to participate in Share save and Buy as You Earn share schemes
  • 15% discount on and free delivery for all employees
  • Income Protection (can be up to 50% of salary for 3 years) and Life Assurance (3 x annual salary)


We also have regular divisional socials, sports clubs not to mention the Ocado Technology Academy for a packed schedule of courses, conferences and events. If you think you have what it takes to make a difference, please submit your application below.


Be bold, be unique, be brilliant, be you. We are looking for individuality and we value diversity. We are an equal opportunities employer and we are committed to treating all applicants and employees fairly and equally. We are committed to making reasonable adjustments to provide a positive, barrier-free recruitment process and supportive work environment. 

If you have any support or access requirements, we encourage you to advise us at the time of application.


We are thrilled to welcome applicants from across the world. Whilst we are able to offer visa sponsorship, please note that we are only able to cover costs relating to the Certificate of Sponsorship and the Immigration Skills Charge only. For all employment offers made for UK roles, it is expected that you will be based in the UK in commutable distance, ready for your first day of work, so please keep this in mind. If you have any questions, please don't hesitate to ask.


Due to the energising nature of Ocado's business, vacancy close dates, when stated, are indicative and may be subject to change so please apply as soon as possible to avoid disappointment. If you have applied and been rejected for this role in the last 6 months, or applied and been rejected for a role with a similar skill set, we will not re-evaluate you for this position. After 6 months, we will treat your application as a new one. All benefits information is subject to change and the terms of the individual arrangements. Please assume you have been unsuccessful if you haven’t heard from us within 4 weeks.


About Ocado Group

When our journey started, we were all about changing the way people shop for groceries. 20 years later, we’re developing our own ground breaking technology, opening multiple sites at an accelerating rate and engaging in exciting new business partnerships around the world!

Transforming an industry also means transforming the way we do business.   As we continually develop new technologies and customer propositions, we’re looking for the Everyday Pioneers to lead us into the next stage of our evolution: enhancing our capabilities, inspiring our teams and developing new ways of working.

Changing the way the world shops, for good.

Stay in the loop

Can't find what you're looking for or not ready for a move? Join our Talent Community to stay up to date with Ocado Group news and events, you’ll also be the first to know about new opportunities - before they are posted!

Join our Talent Community