At a Glance
- Tasks: Create and improve software documentation while collaborating with engineering teams.
- Company: Join Canonical, a pioneering tech firm leading the open-source revolution.
- Benefits: Remote work, personal development budget, annual reviews, and travel opportunities.
- Why this job: Make a real impact on user experience and contribute to innovative open-source projects.
- Qualifications: Technical writing skills, programming mindset, and community engagement in open-source.
- Other info: Dynamic environment with excellent career growth and a focus on documentation excellence.
The predicted salary is between 36000 - 60000 £ per year.
Our ambition is to set a standard of excellence in the industry for technical documentation and documentation practice. This is your chance to be a part of that as a Technical Author at Canonical. We are building documentation capacity at scale. We have dozens of positions available for products and teams across the organisation, at all levels from Graduate to Senior Staff.
The role of a Technical Author involves leading the documentation efforts of an engineering team, typically focused on a product or family of products. You will help the team develop documentation that serves the needs of the product's users, embracing the principles of the Diátaxis documentation framework. You will have a broad impact on and responsibility for the quality of the user experience with the product, contributing toward the long-term success of the project itself.
These are not traditional technical writer roles. As a Technical Author, you will participate in the development of product strategy, have input into product design and user experience, and combine technical expertise with leadership in documentation. You will collaborate with colleagues across the company to establish documentation as a first-class engineering discipline. Even the most junior Technical Authors will have the opportunity to develop and demonstrate technical authority.
As well as your role in an engineering team, you will also be part of Canonical's documentation practice team, which includes all the company's Technical Authors. Here, you will collaborate to define documentation excellence and drive the development of documentation practice and theory across the company and in the open-source software community.
Location: These are fully remote roles, open to candidates across the globe.
The role entails:
- Create, maintain and improve software documentation
- Work with engineering team members to help them make effective documentation contributions
- Influence the development of the product as an expert user of the product, who has important opinions about its function and design
- Engage with user communities to ensure that our documentation meets their needs
- Encourage and support community engagement in and contribution to documentation
- Help standardise the structure, presentation, style and language of content across products
- Collaborate with documentation peers to advance the state of the art in documentation at Canonical
- Challenge and advance documentation understanding and best-practice, as part of a disciplinary team
What we are looking for in you:
- Cares deeply about functional written communication
- Is a technical writer with a programmer's mindset, or a programmer with a record of producing excellent documentation
- Has a record of community engagement in open-source software, documentation, research or other disciplines
- Is sympathetic to the needs and challenges of open-source software and its communities
- Demonstrates technical curiosity and is fascinated by software technology and its challenges
- Has demonstrable documentation skills, insight and enthusiasm
- Has experience of software development contexts; is familiar with Linux, working on the command line, application deployment, system operations, infrastructure management, Git, documentation markup languages
- Has excellent written and verbal communication skills
- Holds a BSc/BA degree or equivalent
- Is able to travel twice a year for up to two weeks for events
Nice-to-have skills:
- Deep technical domain knowledge
- Open-source community leadership and management
- User-experience, interaction or visual design
What we offer you:
- Distributed work environment with twice-yearly team sprints in person
- Personal learning and development budget of USD 2,000 per year
- Annual compensation review
- Recognition rewards
- Annual holiday leave
- Maternity and paternity leave
- Employee Assistance Programme
- Opportunity to travel to new locations to meet colleagues
- Priority Pass, and travel upgrades for long haul company events
About Canonical: Canonical is a pioneering tech firm at the forefront of the global move to open source. As the company that publishes Ubuntu, one of the most important open source projects and the platform for AI, IoT and the cloud, we are changing the world of software. We recruit on a global basis and set a very high standard for people joining the company. We expect excellence – to succeed, we need to be the best at what we do. Most colleagues at Canonical have worked from home since its inception in 2004. Working here is a step into the future, and will challenge you to think differently, work smarter, learn new skills, and raise your game.
Canonical is an equal opportunity employer. We are proud to foster a workplace free from discrimination. Diversity of experience, perspectives, and background create a better work environment and better products. Whatever your identity, we will give your application fair consideration.
Technical Author (multiple roles and seniority levels) in Edinburgh employer: Canonical
Contact Detail:
Canonical Recruiting Team
StudySmarter Expert Advice 🤫
We think this is how you could land Technical Author (multiple roles and seniority levels) in Edinburgh
✨Tip Number 1
Network like a pro! Reach out to current or former Technical Authors at Canonical on LinkedIn. Ask them about their experiences and any tips they might have for landing a role. Personal connections can make a huge difference!
✨Tip Number 2
Show off your skills! Create a portfolio that highlights your best documentation work. Include examples that demonstrate your technical expertise and understanding of user needs. This will help you stand out during interviews.
✨Tip Number 3
Prepare for the interview by brushing up on the Diátaxis documentation framework. Be ready to discuss how you would apply it in real-world scenarios. This shows you're not just a writer, but a strategic thinker who understands documentation excellence.
✨Tip Number 4
Don’t forget to apply through our website! It’s the best way to ensure your application gets seen. Plus, it keeps everything organised for us, making it easier to match you with the right team and role.
We think you need these skills to ace Technical Author (multiple roles and seniority levels) in Edinburgh
Some tips for your application 🫡
Show Your Passion for Documentation: Let us see your enthusiasm for technical writing! Share examples of your previous work and how you've contributed to documentation projects. We want to know what drives you in this field.
Tailor Your Application: Make sure to customise your application for the Technical Author role. Highlight your relevant skills and experiences that align with our ambition for excellence in documentation. A personal touch goes a long way!
Be Clear and Concise: Remember, clarity is key in technical writing. Your application should reflect your ability to communicate effectively. Keep it straightforward and ensure your points are easy to understand.
Apply Through Our Website: We encourage you to submit your application through our website. This helps us streamline the process and ensures your application gets the attention it deserves. Don't miss out on this opportunity!
How to prepare for a job interview at Canonical
✨Know Your Documentation Frameworks
Familiarise yourself with the Diátaxis documentation framework, as it's a key principle for the role. Be ready to discuss how you would apply this framework in your documentation efforts and how it can enhance user experience.
✨Showcase Your Technical Curiosity
Demonstrate your passion for software technology during the interview. Share examples of how you've engaged with open-source communities or contributed to documentation projects, highlighting your technical expertise and curiosity.
✨Prepare for Collaboration Questions
Since collaboration is crucial in this role, think about past experiences where you've worked with engineering teams or other stakeholders. Be prepared to discuss how you influenced product design or documentation practices through teamwork.
✨Communicate Clearly and Effectively
As a Technical Author, strong communication skills are essential. Practice articulating your thoughts clearly and concisely, both verbally and in writing. Consider preparing a brief writing sample that showcases your ability to convey complex information simply.