Find a job 
Featured Companies 
Featured Universities 
For Companies At a Glance
- Tasks: Create and maintain high-quality technical documentation for APIs and platform features.
- Company: Join an award-winning FinTech in Edinburgh with a collaborative culture.
- Benefits: Enjoy 33 days holiday, remote work options, and family healthcare.
- Why this job: Make a real impact by shaping documentation that supports merchants and enhances user experience.
- Qualifications: Experience in technical writing and a solid understanding of APIs and back-end concepts.
- Other info: Be part of a dynamic team with rapid career progression and regular team events.
The predicted salary is between 36000 - 60000 ÂŁ per year.
BR-DGE is an award-winning FinTech founded in Edinburgh. Our platform enables enterprise e-commerce and technology businesses to design, optimise, and scale complex payment infrastructures with confidence. Since 2018, we’ve been building a modern payment orchestration platform that gives merchants control, flexibility, and resilience across their payment stack. Our customers include household names across travel, retail, and regulated gaming sectors, supported by world-class partners such as Visa and Worldpay.
We operate in a highly regulated, technically demanding environment, where reliability, clarity, and execution quality matter. As our platform and customer base continue to grow, high-quality technical documentation is becoming a critical part of how we ship products and support our merchants and will play a central role in allowing us to scale rapidly.
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
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.
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:
- 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.
Technical Writer Hybrid (Edinburgh) Permanent / Full Time about Technical Writer employer: Br Dge
Contact Detail:
Br Dge Recruiting Team
StudySmarter Expert Advice 🤫
We think this is how you could land Technical Writer Hybrid (Edinburgh) Permanent / Full Time about Technical Writer
✨Tip Number 1
Network like a pro! Reach out to folks in the industry, attend meetups, and connect with people on LinkedIn. You never know who might have the inside scoop on job openings or can refer you directly.
✨Tip Number 2
Prepare for interviews by practising common questions and showcasing your skills. Use the STAR method (Situation, Task, Action, Result) to structure your answers and highlight your experience effectively.
✨Tip Number 3
Don’t just wait for job postings; be proactive! Research companies you admire and reach out directly. Express your interest in their work and how you can contribute, even if they’re not actively hiring.
✨Tip Number 4
Apply through our website for the best chance of landing that role! Tailor your application to show how your skills align with the job description, and don’t forget to follow up after applying to keep your name fresh in their minds.
We think you need these skills to ace Technical Writer Hybrid (Edinburgh) Permanent / Full Time about Technical Writer
Some tips for your application 🫡
Tailor Your Application: Make sure to customise your CV and cover letter for the Technical Writer role. Highlight your experience with technical documentation, especially around APIs and developer tools, as this is what we’re really looking for!
Showcase Your Skills: Don’t just list your skills; demonstrate them! Include examples of your previous work, particularly any documentation you've created for complex platforms or APIs. This will help us see how you can contribute to our team.
Be Clear and Concise: Since clarity is key in technical writing, ensure your application is well-structured and easy to read. Use bullet points where necessary and keep your language straightforward – we want to see your writing style shine through!
Apply Through Our Website: We encourage you to apply directly through our website. It’s the best way for us to receive your application and ensures you don’t miss out on any important updates about the process!
How to prepare for a job interview at Br Dge
✨Know Your Stuff
Make sure you brush up on your technical knowledge, especially around APIs and documentation tools like Postman. Familiarise yourself with the company's platform and its features so you can speak confidently about how you would document them.
✨Showcase Your Process
Be ready to discuss your approach to creating and maintaining documentation. Highlight any previous experiences where you established a robust process for documenting new features, as this will resonate well with the role's requirements.
✨Engage with the Team
Demonstrate your ability to collaborate with engineers and product owners. Prepare examples of how you've worked closely with technical teams in the past to ensure documentation aligns with product behaviour and is delivered on time.
✨Ask Insightful Questions
Prepare thoughtful questions about the company's documentation workflows and how they measure success. This shows your proactive nature and genuine interest in improving their processes, which is key for the role.
