Documentation Engineer (Builder Experiences)

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 Polkadot's developer-facing documentation — the primary resource thousands of developers rely on to build smart contracts, launch parachains, and interact with the network. You'll engineer the docs: building automation, designing user journeys, and maintaining a docs-as-code system with CI/CD pipelines and quality checks. AI is a first-class tool here — you'll be expected to use it to improve workflows and keep docs in sync with a fast-moving codebase.

What You'll Do

• Own the full documentation portfolio — reference docs, tutorials, guides, and code snippets
• Build automated pipelines to validate examples, detect broken links, and enforce consistency
• Design and optimise developer user journeys based on real usage data
• Collaborate with protocol and SDK engineers to document features as they ship
• Leverage AI to scale documentation quality and reduce lag between code and docs

Your Skills

• Engineer first - you have code fluency and can build prototypes and products. You understand what our developers do and need
• Docs-as-code experience — static site generators, CI/CD pipelines, and documentation automation
• Practical AI integration — not just prompting, but embedding AI into documentation workflows
• Developer empathy backed by evidence — you've tested docs with real users and improved them based on what you found

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.