Skip to content

Conversation

@msuchane
Copy link
Contributor

Description

This PR adds Git, patching and packaging workflows migrated from the Ubuntu wiki: https://wiki.ubuntu.com/DesktopTeam/git

These guides are mainly written for the Ubuntu Desktop Team but community contributors can also follow them.

Some of the content is similar in its overall purpose to existing Ubuntu Project guides but the Desktop and GNOME workflow is distinct.

Related issue

https://warthogs.atlassian.net/browse/UDENG-6342


Checklist

  • I have read and followed the Ubuntu Project contributing guide
  • My pull request is linked to an existing issue (if applicable)
  • I have tested my changes, and they work as expected

Additional notes (optional)

This documentation needs one final review by Desktop Team members. It's a draft for now.

We can adjust the placement of the files in the documentation set. I realize they don't fit too neatly.

Copy link

@quine00 quine00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for working on this! Comments in-line.

Copy link

@quine00 quine00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Partial review, will come back later. Thanks!

@msuchane msuchane marked this pull request as ready for review October 15, 2025 11:28
@msuchane
Copy link
Contributor Author

Thanks @quine00 for the review so far!

Sally and Robert, please take a look if the placement within the documentation set is appropriate. I chose the patching folder for the maintenance guide because that seemed like the closest fit.

@msuchane
Copy link
Contributor Author

Hi @s-makin and @rkratky, this PR is now basically ready from the engineering side. Let me know what you think about including it in the Project Docs.

The Desktop workflow is different in that it uses git-buildpagage (gbp) to manage patches, while the workflow in Project Docs relies on quilt. I've been told that gbp is basically a better, more modern replacement for quilt: we can consider whether to recommend it by default even outside of the Desktop use cases.

Copy link
Collaborator

@rkratky rkratky left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @msuchane! A bunch of suggestions, questions, and a few nits :)

Copy link
Collaborator

@rkratky rkratky left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @msuchane! A bunch of suggestions, questions, and a few nits :)

@s-makin
Copy link
Collaborator

s-makin commented Oct 27, 2025

Hi @s-makin and @rkratky, this PR is now basically ready from the engineering side. Let me know what you think about including it in the Project Docs.

The Desktop workflow is different in that it uses git-buildpagage (gbp) to manage patches, while the workflow in Project Docs relies on quilt. I've been told that gbp is basically a better, more modern replacement for quilt: we can consider whether to recommend it by default even outside of the Desktop use cases.

Thanks @msuchane - I agree with everything that @rkratky has already picked up on.

With regards to the default workflows, I think the ultimate intention should be for us to be quite opinionated on what's recommended (at least for beginners) - but since everyone has a different workflow, what to align on is a decision for Ubuntu Engineering + the Ubuntu Community to make. For now just having all the docs in one place is good enough, so I would agree with Robert's suggestion to park these pages in the Niche section for the time being.

msuchane and others added 6 commits October 27, 2025 13:05
Co-authored-by: Robert Krátký <robert.kratky@canonical.com>
Co-authored-by: Robert Krátký <robert.kratky@canonical.com>
Co-authored-by: Robert Krátký <robert.kratky@canonical.com>
Co-authored-by: Robert Krátký <robert.kratky@canonical.com>
@msuchane
Copy link
Contributor Author

Thanks for the detailed review @rkratky!

I wasn't aware that the Packaging Guide is now also replaced by Project Docs. Thanks for letting me know.

I absolutely agree that the niche packaging category is the best spot for this content.

I'm gonna resolve the remaining issues and move the pages there.

@msuchane
Copy link
Contributor Author

Hi @rkratky and @s-makin, all reviews and issues are now addressed. The new documentation is in the niche packaging folder. Feel free to merge at your convenience.

Thanks everyone for your help!

@rkratky rkratky merged commit 81ff303 into ubuntu:main Oct 29, 2025
4 checks passed
@msuchane msuchane deleted the desktop-git-guide-UDENG-6342 branch October 29, 2025 14:32
@msuchane
Copy link
Contributor Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants