Ubuntu Maker Canonical Planning To Vastly Improve Its Documentation

guest · Nov 17, 2021

Ubuntu Maker Canonical Planning To Vastly Improve Its Documentation
November 17, 2021
https://www.phoronix.com/scan.php?page=news_item&px=Better-Ubuntu-Docs-2021

Back in the day Ubuntu's Wiki was a great resource for Linux documentation but less so these days while the Arch Linux Wiki is often viewed as a gold standard for open-source documentation. Canonical though is now hoping to radically improve the documentation for Ubuntu and its other software offerings.

Daniele Procida as the Director of Engineering at Canonical since this summer laid out plans for how they plan to dramatically improve their documentation efforts moving forward. Procida commented on their documentation ambitions,

"We have embarked on a comprehensive, long-term project to transform documentation. Our aim is to create and maintain technical documentation and documentation practice that will represent a standard of excellence in the industry. We want it to be the best it possibly can be. By “best” we mean documentation that above all else understands, respects, reflects and serves its users’ needs. These are the values that we stand for, that we will express in our work. They are values that we want to become known for."
Click to expand...

Canonical: The future of documentation at Canonical

One thing that has made it difficult at Canonical is the complexity of our engineering, product and services portfolio. Our software spans a range from single-purpose command-line tools to vertical ecosystems composed of dozens of discrete component products, created by dozens of independent engineering and product teams.

We’ve been able to create unified and coherent software product lines, but we’ve been less successful doing the same for documentation. We want to do better for our documentation users – this is how we’re going to do it.
Click to expand...

Log in or Sign up

Ubuntu Maker Canonical Planning To Vastly Improve Its Documentation

guest Guest

Log in or Sign up

Ubuntu Maker Canonical Planning To Vastly Improve Its Documentation

guest Guest

Useful Searches