canonical/open-documentation-academy

AI Summary: Clarify the wording on the Ubuntu Server documentation page about upgrading, differentiating between software upgrades and OS version upgrades. This involves improving the existing text and potentially adding a table or diagram to better illustrate the process. The solution should be submitted as a pull request to the Ubuntu Server documentation repository.

AI Summary: Add a definition for the term "command-line interface (CLI)" to the existing glossary within the Ubuntu project documentation. The glossary file is a MyST Markdown file, and resources are provided for guidance.

AI Summary: Add a definition for the 'Code of Conduct' term to an existing glossary within the Ubuntu project documentation. This involves editing a Markdown file (glossary.md) using MyST syntax, referencing provided links to the glossary file and MyST documentation.

AI Summary: Add a definition for the term "chroot" to the glossary of the Ubuntu Project documentation. This involves editing a markdown file on GitHub and may require familiarity with MyST Markdown syntax.

AI Summary: Add a definition for the term "code name" to the existing glossary within the Ubuntu Project documentation. The glossary file is a MyST Markdown file, and resources including the file location and published documentation are provided.

AI Summary: The task involves updating the Snapcraft documentation to ensure consistent use of US English spelling. This includes replacing UK spellings (e.g., words ending in -our, -se, -re) with their US English equivalents (-or, -ze, -er). Basic regex knowledge is helpful but not required. The task can be broken down into smaller chunks for collaborative work.

AI Summary: This task involves improving the Ubuntu Server documentation by linking technical terms and acronyms to a newly created glossary. Participants choose a page, identify jargon, and either link existing glossary terms using a specific syntax or report missing terms. The task is designed to be beginner-friendly and can be worked on collaboratively using the GitHub web interface.

AI Summary: Add Ubuntu Core to the list of participating projects in the Open Documentation Academy by updating the README.md and projects.md files. This can be done entirely through the GitHub web interface.

AI Summary: Restructure the Ubuntu Core documentation's "Build your first image" tutorial landing page to improve its usability. This involves either adapting it to a standard landing page template or proposing an alternative design, potentially including removal of the page if deemed unnecessary. The task is specifically designed for first-time documentation contributors.

AI Summary: Fix broken internal links within the Launchpad documentation using the ':ref:' method for linking within restructured text files. This involves identifying broken links in two specified files and correcting them to point to the correct internal pages within the Launchpad documentation hosted on Read the Docs.

AI Summary: Fix broken internal links within the Launchpad documentation using the ':ref:' method described in the provided style guide. This involves updating links on a specific Launchpad documentation page to correctly point to other pages within the same documentation set.

AI Summary: Create an index.rst file for the Launchpad user documentation's 'working-with-code' subdirectory. This involves moving an existing Toctree from a document within the subdirectory into the new index.rst file, adding a heading, adjusting the Toctree's maxdepth, and ensuring the original document is included in the Toctree. The goal is to improve navigation within the Launchpad user documentation.

AI Summary: Fix broken internal links in the Launchpad documentation using the ':ref:' method described in the provided style guide. This involves updating links within specified pages to correctly point to other sections within the Launchpad documentation hosted on Read the Docs.

AI Summary: Create an index.rst file for the Launchpad user documentation's 'translating-with-launchpad' subfolder. This involves moving a Toctree from an existing file into the new index.rst, adding a heading, adjusting Toctree settings (removing ':hidden:' and setting ':maxdepth:' to 1), and ensuring the original file is included in the Toctree. The goal is to improve navigation within the Launchpad user documentation.

AI Summary: Create an index.rst file in the Launchpad user documentation's 'users/explanation/answers' folder. Move the existing Toctree from a file within that folder into the new index.rst, add a heading matching the folder name, remove ':hidden:' if present, change ':maxdepth:' to 1, and add an entry for the original Toctree file to the new Toctree. This improves navigation within the Launchpad user documentation.