Technical Writer

Comcarde Ltd; Remote; GBP 40,000 - 55,000; Full time

Job summary

A technology company in the United Kingdom is seeking a skilled Technical Writer to own and produce comprehensive developer and API documentation. In this flexible remote role, you will collaborate closely with Engineers and Product Owners to ensure new features are documented accurately and promptly. The ideal candidate has proven experience in technical documentation, a strong command of written English, and knowledge of API tools like Postman. Join a culture that values documentation as a key part of the product process.

Benefits

Flexible and remote working

33 days holiday including public holidays

Birthday off

Family healthcare

Life insurance

Employee assistance programme

Investment in learning and development

Regular team events and off‑sites

Qualifications

• Proven experience writing technical documentation for APIs or complex platforms.
• Strong written English with attention to clarity and audience.
• Familiarity with back-end concepts such as APIs and authentication.

Responsibilities

• Establish and run a process for documenting new product functionality.
• Own the creation of high-quality documentation for APIs and integrations.
• Work with Engineers to review design documents and validate behavior.

Skills

Technical documentation

API usage

Written English

Organisational skills

Tools

Postman

ReadMe

Job description

All BR-DGE Builders Receive The Following Benefits

• Flexible and remote working
• Remote working allowance
• 33 days holiday including public holidays
• Your birthday as a day off
• Family healthcare
• Life insurance
• Employee assistance programme
• A culture that champions rapid career progression
• Investment in your learning and development
• Regular team events & socials

Become a BR-DGE Builder

About The Role

We are looking for a Technical Writer to take ownership of our developer and API documentation, with a strong focus on ensuring new functionality is documented clearly, accurately, and on time.

This is a hands‑on role embedded within our product and engineering workflows. You will work closely with Engineers and Product Owners to shape, write, and maintain documentation as features are delivered, reducing the gap between development completion and merchant‑ready documentation.

The role is proactive by design. You’ll work with a visible pipeline of upcoming features, engaging early with design and implementation to ensure documentation is ready when customers need it.

What You’ll Be Doing

• Establish and run a robust, repeatable process for documenting new product functionality as it is released.
• Own the creation of high‑quality, merchant‑facing documentation for APIs, integrations, and platform features.
• Work directly with Engineers during feature delivery to:
  • review design documents
  • exercise APIs using tools such as Postman
  • ask clarifying questions and validate behaviour
• Partner with Product Owners to validate that documentation reflects intended product behaviour, while removing documentation workload from POs.
• Maintain and improve documentation structure, clarity, and discoverability within our existing platform (ReadMe).
• Allocate roughly 70% of time to net‑new documentation and 30% to cleanup and restructuring of existing docs.
• Contribute to defining what “good” documentation workflows look like, and collaborate with stakeholders to simplify and improve publishing processes.
• Ensure documentation is timely, accurate, and aligned with release timelines.

What We’re Looking For

Core Requirements

• Proven experience writing technical documentation for APIs, developer tools, or complex platforms.
• Strong written English, with excellent attention to clarity, structure, and audience.
• Hands‑on experience using Postman or similar tools to exercise APIs.
• Solid understanding of back‑end concepts such as APIs, authentication, data flows, and environments.
• Comfortable working directly with Engineers and Product teams in an agile environment.
• Ability to drive documentation proactively, rather than waiting for requests.
• Strong organisational skills and ability to manage multiple documentation streams in parallel.

Nice to have

• Experience investigating issues beyond API usage, such as logs, tracing, or database behaviour.
• Background in payments, fintech, or other regulated industries.
• Experience improving or redesigning documentation workflows and publishing pipelines.
• Hybrid backgrounds such as former engineers, Technical Support Engineers, or API specialists who have moved into documentation.

Tools & Environment

• Documentation platform: ReadMe
• API tooling: Postman
• Close collaboration with Engineering, Product, and Technical Solutions teams
• Access to staging and sandbox environments provided

What Success Looks Like

Within the first 90 days

• A clear, reliable process for documenting new features is in place and being followed
• Documentation for new releases is consistently being delivered to a high standard

Within 6 Months

• The time between feature completion and merchant‑ready documentation is significantly reduced
• Documentation quality supports faster merchant adoption and fewer clarification loops with Product and Support

Beyond

• Positive feedback about quality of documentation, ease of integration, and our team’s contribution to the successful outcomes of our commercial and implementation teams
• Reduction in time spent on request servicing, with self‑serve resources enabled to free our Product and Customer Support teams’ time for other high‑value activity

What We Offer

• Flexible, remote‑first working
• 33 days holiday, including public holidays
• Birthday off
• Family healthcare
• Life insurance
• Employee assistance programme
• Investment in learning and development
• Regular team events and off‑sites
• A collaborative culture where documentation is treated as a first‑class product

Apply for this role