Documentation is at the core of Notion’s API — thousands of developers visit our developer site every day to learn how to use our APIs to build new and interesting integrations. Our developer site includes API references, guides, examples, and code samples to help guide our developers on their journey.
In this role you’ll be responsible for writing documentation for new APIs, revamping existing documentation and guides, and creating new code samples.
What You'll Achieve
Develop comprehensive, well-structured, and easy-to-understand API documentation (developers.notion.so), including guides, reference manuals, code samples, and tutorials, that cater to various levels of technical expertise.
Collaborate with software engineers, product managers, and partner engineers to gather technical specifications and insights required for creating accurate API documentation.
Continuously monitor changes and updates to our APIs and proactively update the documentation to reflect the latest features, enhancements, and best practices.
Understand the needs of our community, coalesce their use cases, and write sample code to help inspire developers on their journey.
Skills You'll Need To Bring
Be passionate about writing, both reference documentation and long form content, with an ability to explain complex technical concepts to a broad audience.
Have a technical background with familiarity with REST APIs with the ability to write clean code samples.
A portfolio of technical writing you have done in the past.
Nice To Haves
Previous experience writing technical documentation for an enterprise platform.