Documentation Engineer

At Parity, we are building the core infrastructure for a better web,one that respects individual freedom and empowers developers to create trustworthy, decentralized services. As the minds behind Polkadot and Kusama, we are laying the groundwork for Web3. Our mission is to make Polkadot the most innovative community in blockchain, and that starts with making it accessible to the people building on .

 We are looking for a Documentation Engineer to join our Builder Experiences team. In this role, you aren’t just “writing manuals”; you are engineering the primary resource that thousands of developers rely on to launch parachains, build smart contracts, and run infrastructure. You’ll be treated as a product owner for our knowledge base, using automation, AI, and developer empathy to ensure our documentation is as robust as our code.

The Mission

You will own the end-to-end developer journey. This means treating documentation like production software—complete with CI/CD pipelines, automated testing, and constant iteration based on real-world usage.

What You’ll Be Doing Every Day:

• Owning the Portfolio: You’ll manage everything from reference docs and cookbooks to high-level tutorials. You’ll guide other engineers on how to contribute, ensuring everything we publish is accurate and high-quality.
• Building Automation: You’ll create pipelines that validate code snippets, catch broken links, and flag stale content. If an SDK update breaks a tutorial example, you should be the first to know.
• Designing User Journeys: You’ll analyze where developers get stuck and restructure our information architecture to fix those pain points, turning raw data into actionable insights.
• Collaborating with the Best: You’ll work directly with protocol engineers and tool maintainers, translating complex technical “know-how” into guides that external developers can actually follow.
• AI-First Workflows: You’ll use AI to scale our quality—think automated style-guide enforcement on PRs, AI-assisted drafts, and intelligent search over our entire corpus.

What You Bring to the Team

We’re looking for someone who speaks the language of developers and has the technical depth to navigate Rust, TypeScript, and Python codebases.

The Essentials:

• Technical Fluency: You can read a Rust crate or a TypeScript SDK and write a tutorial that a developer can follow from start to finish without getting stuck. You believe in runnable examples, not pseudocode.
• Docs-as-Code Expertise: You’ve worked with tools like MkDocs or Docusaurus and have built CI/CD pipelines for documentation. You think of docs infrastructure the same way a dev thinks of app infrastructure.
• AI Adept: You don’t just prompt ChatGPT; you understand how to integrate LLMs and AI tools into documentation pipelines to reduce the lag between code shipping and docs updating.
• Developer Empathy: You treat documentation as a product. You’ve tested your work with real users and aren’t afraid to restructure content based on where people are struggling.

Why You’ll Love Working With Parity

• Remote-First Culture: We are a global, decentralized team. You’ll have the flexibility to work where you’re most productive, with regular retreats to connect with your teammates in person.
• Impact at Scale: Your work will directly influence the growth of the Polkadot ecosystem and the future of the decentralized web.
• World-Class Talent: You’ll be surrounded by some of the brightest minds in Web3, in an environment that values open-source contribution and innovation.
• Inclusive & Equal: We welcome diversity and want everyone in our collective to feel included and welcome.