The Role
We're looking for a Technical Writer to own the documentation experience for Nabu Casa Hardware and Cloud. This is a high-ownership, high-impact role: you'll be the primary person responsible for making our products accessible to a global community of users and developers — from first-time setup guides to deep API and integration documentation. You'll work directly with engineers to translate technical complexity into content that empowers users to succeed independently, without needing to raise a support ticket.
What you are going to do
- Own the end-to-end documentation experience for Nabu Casa Hardware and Cloud, ensuring content is accurate, up-to-date, 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, reducing the documentation burden on the engineering team
- Audit and improve existing documentation continuously — flagging outdated content, filling gaps, and improving structure and tone
- Define and maintain documentation standards, style guides, and templates so that community contributions are consistent and maintainable
- Triage and act on documentation feedback from the community, support, and internal teams to prioritise what improves user outcomes most
- Contribute to the developer experience — API guides, integration documentation, and contributor docs — to support the OHF community and partner integrations
- Track documentation quality signals (support ticket themes, community feedback) and report on them regularly
What you need to have
- Strong technical writing skills with a portfolio of developer or product documentation
- Ability to read and understand code (Python, YAML, 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 (Git, Markdown, 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: knows how to get technical information out of busy engineers efficiently
It would be great if you also have:
- Familiarity with Home Assistant or similar open-source or self-hosted software
- Experience maintaining documentation for a community-driven project with external contributors
- A systematic approach to auditing large documentation sets and prioritising improvements methodically
- Experience working async in a remote-first, distributed team