Technical Author

5 days ago


Muscat, Muscat, Oman Canonical Full time

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.

All applications and candidates are handled through this one entry-point. We'll be able to discuss seniority levels, suitable teams and more later in the process, to help place you in the most suitable role for you.

The role of a Technical Author

A Technical Author leads the documentation efforts of an engineering team, typically focused on a product or family of products. You'll 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, and will contribute towards the long-term success of the project itself.

These are not traditional technical writer roles. As a Technical Author, you will participate in development of product strategy. You will have input into product design and user experience. You will combine technical expertise with leadership in documentation, collaborating 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 a part of Canonical's documentation practice team, that includes all the company's Technical Authors. Here, you'll be amongst other documentation experts, who 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, and 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

We consider geographical location, experience, and performance in shaping compensation worldwide. We revisit compensation annually (and more often for graduates and associates) to ensure we recognise outstanding performance. In addition to base pay, we offer a performance-driven annual bonus or commission. We provide all team members with additional benefits, which reflect our values and ideals. We balance our programs to meet local needs and ensure fairness globally.
  • 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 - in order 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.

#J-18808-Ljbffr
  • Technical Author

    3 weeks ago


    Muscat, Muscat, Oman Canonical Full time

    Technical Author (multiple roles and seniority levels)Join to apply for the Technical Author (multiple roles and seniority levels) role at CanonicalTechnical Author (multiple roles and seniority levels)Join to apply for the Technical Author (multiple roles and seniority levels) role at CanonicalGet AI-powered advice on this job and more exclusive...


  • Muscat, Muscat, Oman beBeeInterface Full time $90,000 - $110,000

    WSP Oman is seeking a qualified and proactive Interface Engineer to join our dynamic team on the Sohar Port Project.The successful candidate will play a key role in managing and coordinating technical and contractual interfaces between various stakeholders to ensure smooth execution and integration across all project components. Qualifications:Bachelor's...


  • Muscat, Muscat, Oman beBeeDocumentation Full time 4,000 - 4,500

    Documentation Excellence: Technical Author RoleThe role of a Technical Author is to lead documentation efforts for engineering teams, focusing on product or family of products. You will help develop documentation that serves user needs, embracing Diátaxis documentation framework principles.As a Technical Author, you will have broad impact and responsibility...


  • Muscat, Muscat, Oman beBeeProjectSpecialist Full time 3,000 - 4,500

    Role summary:Vodafone is Oman's latest Network Operator. The presence of Vodafone in Oman will contribute to the development of all sectors, including the economic and educational sectors.We are looking for energetic self-starters to work in a 100% Omani owned, positive collaborative start-up environment, where key talents will create Oman's happiest...


  • Muscat, Muscat, Oman beBeeMarketing Full time 80,000 - 120,000

    Job DescriptionThis role entails identifying and capitalizing on prospective projects with potential for construction and mechanical scope. It involves obtaining prequalification for ITB/RFQs and securing consensus to bid.The position requires coordination with relevant Heads of Business Development for strategizing and with clients for queries and...


  • Muscat, Muscat, Oman Oman Air Full time

    Role Objectives:Responsible for developing, managing, and controlling the Aircraft Maintenance Schedule (AMS), monitoring the Technical Reliability of the fleet, and ensuring the development and continuous review of the Minimum Equipment List (MEL). Ensuring compliance with regulatory requirements, Manufacturer requirements, company requirements and supports...


  • Muscat, Muscat, Oman Menasa & Partners Full time

    An international engineering consultancy with a strong reputation for delivering innovative engineering solutions has an immediate opening for a Senior Structural Engineer to join their team in Muscat, Oman.The successful candidate will be a key contributor to the delivery of large-scale building projects, including healthcare, hospitality, and mixed-use...


  • Muscat, Muscat, Oman Menasa & Partners Full time

    Senior Structural Engineer – Post Tension DesignAn international engineering consultancy with a strong reputation for delivering creative engineering solutions has an immediate opening for a Senior Structural Engineer in Muscat, Oman.The successful candidate will play a key role in delivering large-scale building projects, including healthcare,...


  • Muscat, Muscat, Oman beBeeStructuralEngineering Full time 90,000 - 120,000

    Project Lead: Structural Engineering SpecialistA key position is available for a highly skilled and experienced Structural Engineer with expertise in post-tension design.About the RoleWe seek an accomplished and dynamic Structural Engineer to lead our team in delivering high-profile building projects. The ideal candidate will possess strong technical skills...


  • Muscat, Muscat, Oman beBeeStructuralEngineer Full time 75,000 - 151,000

    We are seeking a seasoned Senior Building Solutions Specialist to join our team in Muscat, Oman.The successful candidate will play a pivotal role in delivering large-scale building projects, encompassing healthcare, hospitality, and mixed-use developments. Responsibilities include managing projects from both a financial and technical standpoint, requiring...