Technical Writer

About the Role

Day-to-day, you will be responsible for planning, creating, and maintaining high-quality documentation for Nabu Casa's products and services. This includes setup guides, API documentation, and deep dives into the technology, ensuring that the content is accurate, up-to-date, and easily discoverable. Your work will directly impact the user experience, making it essential to stay in tune with the community's feedback and the product development cycle.

You will report to the VP Commercial and work as part of a remote-first, distributed team. This means you'll need to be self-directed, able to manage your time effectively, and comfortable with asynchronous communication. The role offers a unique blend of autonomy and collaboration, requiring you to be proactive in seeking out information and feedback from stakeholders while also being part of a team that values open communication and transparency.

What You Will 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 to ensure consistency and maintainability of community contributions.
• Triage and act on documentation feedback from the community, support, and internal teams to prioritize improvements that enhance user outcomes.
• Contribute to the 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 to inform improvement strategies.

What We Are Looking For

• 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, with the ability to identify what needs to be written without waiting to be told.
• Strong stakeholder management skills, knowing how to get technical information out of busy engineers efficiently.
• Familiarity with open-source projects and community-driven documentation is a plus.

Nice to 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 prioritizing improvements methodically.
• Experience working asynchronously in a remote-first, distributed team.

Benefits and Perks

• The opportunity to work on a product that makes a real difference in people's lives, focusing on privacy, choice, and sustainability.
• A fully remote work arrangement, offering flexibility and work-life balance.
• Competitive compensation package, though specifics are not disclosed.
• The chance to be part of a community-driven project with a large and active user base.
• Professional development opportunities, especially in the realms of technical writing, open-source software, and smart home technology.
• Access to the latest smart home technology and innovations.
• A culture that values open communication, transparency, and community feedback.

• When applying, ensure your portfolio showcases your ability to create concise, technical documentation that is accessible to a broad audience.
• Highlight any experience with open-source projects or community-driven documentation to stand out.
• Prepare to discuss your process for staying updated with the latest developments in smart home technology and how you incorporate this knowledge into your documentation.
• Be ready to share specific examples of how you have improved documentation processes or quality in previous roles.
• Demonstrating your understanding of docs-as-code workflows and your ability to work independently with engineering teams will be crucial in the interview process.
• Consider reaching out to current or former employees to gain insights into the company culture and expectations for the role.