Technical Writer
Skills
APIDocumentationEngineeringGeneratorsMarkdownResearch SkillsSystematic Approach
What the job involves
The main requirements, responsibilities and hiring steps.
Requirements
- Strong technical writing skills with a portfolio of developer or product documentation
- Ability to read and understand code such as Python YAML and REST APIs well enough to write accurate technical content without constant hand-holding from engineers
- Good understanding of smart home hardware and electronics with the ability to troubleshoot basic issues independently
- Experience with docs-as-code workflows including Git Markdown and static site generators such as MkDocs or Docusaurus
- High autonomy and self-direction able to identify what needs to be written without waiting to be told
- Strong stakeholder management and ability to get technical information out of busy engineers efficiently
Nice to have
- Home Assistant familiarity
- Open-source documentation experience
- Systematic documentation auditing
- Async remote teamwork
Day to day
- Own the end-to-end documentation experience for Nabu Casa Hardware and Cloud, ensuring content stays accurate and discoverable
- Plan and deliver documentation for new features integrations and releases in sync with the product shipping cycle
- Work directly with engineers to research and verify technical content while reducing the documentation burden on the engineering team
- Audit and improve existing documentation continuously by flagging outdated content filling gaps and improving structure and tone
- Define and maintain documentation standards style guides and templates so community contributions remain consistent and maintainable
- Triage documentation feedback from the community support and internal teams to prioritise improvements that best support users
- Contribute to developer experience through API guides integration documentation and contributor docs to support the OHF community and partner integrations
- Track documentation quality signals such as support ticket themes and community feedback and report on them regularly
Hiring process
- Apply for the role
- Our team will review your application with the hiring manager
- HR Screening
- Take home assignment
- Interview with our Commercial Team
- Interview with our CEO
- Offer
- Join our team