Job Description
In this role, you will help us improve the Sisense developer experience via documentation, including code examples and tutorials. You will be responsible for creating, publishing, and maintaining user-centric developer documents from concept to code. You will partner with product managers, development teams, and other stakeholders to build API/developer documentation, including samples and more. You will be responsible for the end-to-end content creation process, including content strategy, IA design, AI audits, writing, editing, reviews, and publication.
Responsibilities:
- Lead the content strategy, Information Architecture (IA) design, and maintenance for the developer documentation site.
- Drive a “Clean Sweep” initiative to overhaul the information architecture for both human and AI developers and migrate content to the new Docusaurus-based infrastructure (possible to use a different platform if preferable).
- Implement an “AI-First Design” strategy, using llm.txt standards and structured solution summaries to ensure content is legible to LLMs and reduces hallucination in AI-generated code.
- Produce high-quality documentation (API & SDK docs, feature guides, release notes) that is intent-based, rewriting tutorials to include the “Why” and “Use Case” descriptions alongside technical steps.
- Collaborate with the REST API engineering team on documentation sanitation, migrating high-priority endpoints to OpenAPI 3.0 specs, and providing detailed usage explanations.
- Create and maintain accurate code samples, including embedding interactive and editable code examples and the Compose SDK playground directly into the documentation.
- Perform final “Human-AI” clarity audits on all tutorials before launch.
- Work closely with R&D and Product teams to ensure the quality and accuracy of all content.
- Act on feedback from the field, both inside and outside the organization, in order to continually improve the documentation.
Requirements:
- English mother-tongue or mother-tongue equivalent.
- 4+ years of experience authoring complex technical documentation for a developer or engineering audience.
- Established track record of project ownership, project management, and self-direction, with proven experience in defining Information Architecture.
- Deep experience with SDK or API documentation for an engineering audience. Knowledge of REST APIs, OpenAPI, and familiarity with JavaScript front end frameworks or Typescript are a must.
- Hands-on experience with code and software development tools such as IDEs (Visual Studio, WebStorm, etc.) and Source Control (GitHub, Gitlab, etc.).
- Ability to understand code samples and improve their documentation, both inline and externally.
- Familiarity with API documentation tools such as Swagger or OpenAPI.
- Great communication skills, written and verbal.
- “Self-starter” mindset with a bias for action.
- BA/BS in Computer Science, English, or equivalent work experience.
Preferences:
- Experience with Docusaurus, MDX, and modern static site generators.
- Experience writing documentation in Markdown format.
- Knowledge of BI, data analytics, and big data technologies.
- Familiarity with web or application development technologies such as React, Angular, or Vue.
- Experience collaborating across multiple teams and competing deadlines.
