Your submission was sent successfully! Close

You have successfully unsubscribed! Close

How to write an Ubuntu tutorial

David Callé

on 28 November 2017

Since we started building a learning platform at tutorials.ubuntu.com, we have published over 30 tutorials on a wide range of Ubuntu-related topics: for developers wanting to assess new technologies (such as installing Kubernetes or running Linux containers on Windows) and users (such as using the snap command and creating bootable Ubuntu USB sticks on Windows).

After several iterations and some great feedback from readers, we are now confident the platform is able to handle external contributions.

As a result, today, we are:

Welcoming our first Google Code-in students

Since we are a mentoring Google Code-in organization this year, we have prepared a list of documentation tasks for all skills, ranging from testing existing tutorials and suggesting topics to writing a first tutorial under the guidance of the documentation team. These tasks (and tutorial requests in general) should give a good idea of the content we are trying to cover.

Publishing a ‘How to write a tutorial’ tutorial

Although there has been a guide to creating tutorials for the platform for some time, we have given this a major overhaul to cover additional details, as well as the bare mechanics of how the platform works. This guide is presented as an example tutorial itself, taking you from having a topic idea, through writing down the content in a structured way, to making the most of the tutorials engine and submitting your proposal for review by professional writers and engineers.

Ubuntu tutorials are project focused, taking readers from A to B without getting too much into conceptual explanations. The aim is that they can work (as much as possible) in place of or addition to practical, peer-to-peer learning. Creating a tutorial is also a great and valuable experience for the author too – there is no better way to get on top of a subject than trying to explain it to someone else!

If you feel like you have some solid practical knowledge you can share, or you want to make a valuable contribution to an Ubuntu-related project, why not read our ‘How to write a tutorial’ tutorial and share your knowledge with a wider audience.

Talk to us today

Interested in running Ubuntu in your organisation?

Newsletter signup

Select topics you're
interested in

In submitting this form, I confirm that I have read and agree to Canonical's Privacy Notice and Privacy Policy.

Related posts

Help us build better doc

We want you to join our Ubuntu circle, and help us document MAAS. More minds, more eyes, more hands make better doc.

Snapcrafters: 2022 wrap-up

This article was written by Merlijn Sebrechts and Dani Llewellyn from the Snapcrafters community. ===== Last year, we officially re-launched the...

Ubuntu Summit Memories Live On

The Ubuntu Summit in Prague was a wonderful and busy few days spent together. There were lots of amazing talks, workshops, and fun times had outside the hotel...