search

canonical / ubuntu-packaging-guide

A Guide for new Ubuntu Contributors to learning all about Ubuntu Development and Packaging.
https://canonical-ubuntu-packaging-guide.readthedocs-hosted.com/en/latest/
Other
8 stars 15 forks source link

Explanation/development process #62

Closed dviererbe closed 2 weeks ago

dviererbe commented 2 months ago

[!IMPORTANT] This PR is targeted against #53 for better readability of the diff. Set the base to the 2.0-preview branch before merging!

This PR adds the initial content for the explanation article of the Ubuntu development process.

(This PR is based on #54, fixed the spelling mistake in the branch name and rebased onto explanation/merges-and-syncs)

dviererbe commented 2 months ago

The failed CI checks are related to https://discourse.ubuntu.com/ and https://discourse.canonical.com/ being down. Nothing for me to action on, but the RTD build fail, which is weird.

EDIT: Failure is caused by: /home/docs/checkouts/readthedocs.org/user_builds/canonical-ubuntu-packaging-guide/checkouts/62/docs/explanation/development-process.rst:16: WARNING: term not in glossary: 'seeds'

dviererbe commented 2 months ago

Nice, all checks have passed here too now! 🎉

dviererbe commented 2 weeks ago

About the passive voice: I realize it's not always possible or suitable, but in places where its use can be avoided, it's worth trying. The text is then easier to read, and sometimes it also forces us to provide more specific info instead of "hiding" behind the anonymity of the passive :)

I will keep this in mind for writing future texts :)