--- title: How to write an Ubuntu tutorial description: '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 […]' url: https://canonical.com/blog/how-to-write-an-ubuntu-tutorial?format=md --- 1. [Blog](https://canonical.com/blog) 2. Article --- [David Callé](https://canonical.com/blog/author/davidc3-2 "More about David Callé") 28 November 2017 # How to write an Ubuntu tutorial [Community](https://canonical.com/blog/tag/community) [documentation](https://canonical.com/blog/tag/documentation) --- Share the article Since we started building a learning platform at [tutorials.ubuntu.com](https://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](https://tutorials.ubuntu.com/tutorial/install-kubernetes-with-conjure-up) or [running Linux containers on Windows](https://tutorials.ubuntu.com/tutorial/tutorial-windows-ubuntu-hyperv-containers)) and users (such as [using the snap command](https://tutorials.ubuntu.com/tutorial/basic-snap-usage) and [creating bootable Ubuntu USB sticks on Windows](https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-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](https://github.com/canonical-websites/tutorials.ubuntu.com/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Tutorial+Request%22) 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’](https://tutorials.ubuntu.com/tutorial/tutorial-guidelines) tutorial and share your knowledge with a wider audience. ## Sign up for our newsletter Get the latest Canonical news and updates in your inbox. Work email: \*I agree to receive information about Canonical's products and services. By submitting this form, I confirm that I have read and agree to [Canonical's Privacy Policy](https://canonical.com/legal/dataprivacy). Sign up ## Share on --- ## Related posts [### Canonical becomes Gold Sponsor of Trifecta Tech Foundation](https://canonical.com/blog/canonical-becomes-gold-sponsor-of-trifecta-tech-foundation) Canonical is pleased to announce it is now a Gold Sponsor of the Trifecta Tech Foundation, a non-profit that creates open source building blocks for critical infrastructure... [Canonical](https://canonical.com/blog/author/canonical) 30 June 2026 [### Unmasking the Resolute Raccoon](https://canonical.com/blog/unmasking-the-resolute-raccoon) You’ve almost certainly seen them… In the forest, rummaging through a dumpster, in poorly aging millennial memes. Raccoons are ubiquitous and endlessly entertaining creatures.... [Aaron Prisk](https://canonical.com/blog/author/aaronprisk) 26 February 2026 [### A year of documentation-driven development](https://canonical.com/blog/a-year-of-documentation-driven-development) For many software teams, documentation is written after features are built and design decisions have already been made. When that happens, questions about how a feature is... [Yanisa Haley Scherber](https://canonical.com/blog/author/yanisa-hs) 17 February 2026 [### The foundations of software: open source libraries and their maintainers](https://canonical.com/blog/the-foundations-of-software-open-source-libraries-and-their-maintainers) Open source libraries are repositories of code that developers can use and, depending on the license, contribute to, modify, and redistribute. Open source libraries are usually... [Isobel Kate Maxwell](https://canonical.com/blog/author/iso-maxwell) 13 February 2026