Documentation Engineer (Builder Experiences)
About Us
Parity is one of the world’s most experienced companies building the core infrastructure behind blockchain - the system that allows information and value to be shared securely without needing an intermediary. We’re laying the foundation for a better web which respects the freedom and data of individuals, and empowers developers to build better, more trustworthy online services.
Our remote-first, global team develop open-source software that anyone can use or improve. This includes Polkadot, Polkadot SDK, and Kusama - key parts of the Web3 tech stack, the next generation of the internet. Our mission is to make Polkadot the most active and innovative community in blockchain, powering a new era of connected and decentralised applications.
About the Team
This role sits in our Acceleration department, home to the people who drive ecosystem growth by building tools, integrations, and partnerships across the Polkadot network.
Reporting into our Engineering Lead, you’ll be joining our Builder Experiences team. This team is responsible for accelerating both internal and external developers that build on Polkadot. It’s a large canvas offering lots of opportunities, from reasoning through how we can bring AI assistants to help to building better CI/CD tools, more expressive documentation or just creating tutorials that delight people on their first hands-on experience.
About the Role
As a Documentation Engineer, you'll own the developer-facing documentation across Polkadot - the primary resource that thousands of developers rely on to build smart contracts, launch parachains, run infrastructure, and interact with the network.
This isn't a role where you just write and forget. You'll engineer the documentation: building automation to keep code examples honest, designing user journeys that guide developers from first interaction to production, and maintaining a large-scale docs-as-code system with CI/CD pipelines, automated linting, and quality checks.
Polkadot's documentation spans a wide surface - from Ethereum migration guides to parachain runtime customisation to validator operations - across multiple programming languages (Rust, TypeScript, Python). You'll need enough technical depth to work with these codebases, and enough editorial judgement to make complex protocol concepts genuinely accessible.
And like everything on this team, AI is a first-class tool here. You'll be expected to think about how AI can improve documentation workflows - from automated review to content generation to keeping docs in sync with a fast-moving codebase.
What you’ll do
Documentation Ownership: Own the full developer documentation portfolio - reference docs, tutorials, guides, cookbooks, and code snippets spanning smart contracts, parachains, chain interactions, node infrastructure etc. You won’t be expected to write everything alone, so you’ll need to guide the other engineers on how to create content, striving for accuracy, completeness, and quality.
Automation & Testing: Build and maintain automated pipelines that validate code snippets, detect broken links, flag stale content, and enforce style consistency. Treat documentation like code - if a tutorial's example breaks after an SDK update, you should know before a developer does.
User Journey Design: Map and curate developer user journeys end-to-end. Analyse where developers get stuck, restructure information architecture based on real usage patterns, create analytics and derive actionable insights from them.
Cross-Team Collaboration: Work directly with protocol engineers, SDK teams, and ecosystem tool maintainers to document new features as they ship. Extract knowledge from engineers and translate it into documentation that external developers can actually follow. Also empower other engineers to be able to contribute to the documentation.
AI-Enhanced Workflows: Leverage AI to scale documentation quality - automated style-guide enforcement on PRs, AI-assisted content drafts, web MCPs, llms.txt, intelligent search and retrieval over the docs corpus. Keep up to date with the latest and greatest in AI and leverage it to reduce the lag between code shipping and docs being updated.
Your skills
Technical writing with code fluency: You can read a Rust crate or a TypeScript SDK, understand what it does, and write a tutorial that a developer can follow end-to-end without getting stuck. Show us documentation you've written where the code examples actually work - not pseudocode, not hand-waving, but tested, runnable examples. In this role, you will touch almost everything that Polkadot has to offer through the developer documentation and you are expected to ramp up, understand the code and then document it in user journey based tutorials.
Docs-as-code engineering: You've worked with static site generators (MkDocs, Docusaurus, or similar), written CI/CD pipelines for documentation, and built automation that catches problems before they reach production. You think of docs infrastructure the same way a developer thinks of application infrastructure.
AI adept: This is a team that believes we need to win with AI. You have practical experience using AI tools in your writing or engineering workflow - not just prompting ChatGPT, but integrating AI into documentation pipelines, automated review, or content quality systems.
Developer empathy through evidence: You've tested your documentation with real developers and changed it based on what you found. You can point to a time where you identified that developers were struggling with existing docs, diagnosed the root cause, and restructured the content to fix it. You think of documentation as a product and make it accessible to the users.
About Working With Us
Joining Parity means joining team mates who are genuinely excited about the impact their projects are having, and the opportunity to grow alongside some of the brightest minds in the Web3 space! You’ll work remotely and flexibly, while still getting to meet your team mates throughout the year at team and company-wide retreats.
Upon receiving an offer, all candidates undergo a background check through Zinc, our trusted third-party provider. Team members will be taken on as a contractor via our UK entity. View our Applicant Notice to see how we use your data.
Parity is an Equal Opportunity Employer. We welcome diversity in our global team and care about everyone in our collective feeling included and welcome
Is this position not quite your match? Browse our other open roles.