From e3d6091b262d402a5c330ea75150876ca060370d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= Date: Fri, 23 Jan 2026 10:07:25 +0100 Subject: [PATCH] doc: Contributions are now made on Codeberg. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * doc/contributing.texi (Submitting Patches): Document Codeberg pull requests as the only method. Mention guix-patches@gnu.org in a footnote. Remove paragraphs about of ‘git send-email’ and the associated workflow. Reported-by: Nick Blumenauer Change-Id: Ifbd46665a14a83f014ddff4234cc69bf93c3a8d1 --- doc/contributing.texi | 54 ++++++++----------------------------------- 1 file changed, 9 insertions(+), 45 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index c0a426db8af..4ffb8e9dc87 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -1948,35 +1948,19 @@ keyword parameters for procedures that take more than four parameters. @node Submitting Patches @section Submitting Patches +@cindex pull requests +@cindex patch submission Development is done using the Git distributed version control system. Thus, access to the repository is not strictly necessary. We welcome -contributions in one of the following forms: - -@itemize -@item -@cindex pull request, for contributions -As a @dfn{pull request} (PR) at -@url{https://codeberg.org/guix/guix/pulls/}. This is now the preferred -form. - -@item -Until December 31st, 2025@footnote{This date is the result of a decision -made collectively in +contributions as @dfn{pull requests} (PR) at +@url{https://codeberg.org/guix/guix/pulls/}@footnote{Before January 1st, +2026, changes would be submitted by email to +@email{guix-patches@@gnu.org} and could be +@uref{https://issues.guix.gnu.org, browsed online}. In accordance with @uref{https://codeberg.org/guix/guix-consensus-documents/src/branch/main/002-codeberg.md, -Guix Consensus Document 002} in May 2025.}, you may also send patches as -produced by @code{git format-patch} to the @email{guix-patches@@gnu.org} -mailing list (@pxref{Submitting patches to a project,,, git, Git User -Manual}). +Guix Consensus Document 002}, this method is no longer supported.}. -This mailing list is backed by a Debbugs instance, which allows us to -keep track of submissions (@pxref{Tracking Bugs and Changes}). -Each message sent to that mailing list gets a new tracking number -assigned; people can then follow up on the submission by sending email -to @code{@var{ISSUE_NUMBER}@@debbugs.gnu.org}, where @var{ISSUE_NUMBER} -is the tracking number (@pxref{Sending a Patch Series}). -@end itemize - -Either way, contributors are encouraged to take a moment to set some Git +Contributors are encouraged to take a moment to set some Git repository options (@pxref{Configuring Git}) first, which can improve the readability of patches. Seasoned Guix developers may also want to look at the section on commit access (@pxref{Commit Access}). @@ -2143,26 +2127,6 @@ guix pull --url=/path/to/your/checkout --profile=/tmp/guix.master --disable-auth @end enumerate -When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as -a subject, if your patch is to be applied on a branch other than -@code{master}, say @code{core-updates}, specify it in the subject like -@samp{[PATCH core-updates] @dots{}}. - -You may use your email client, the @command{git send-email} command -(@pxref{Sending a Patch Series}) or the @command{mumi send-email} -command (@pxref{Debbugs User Interfaces}). We prefer to get patches in -plain text messages, either inline or as MIME attachments. You are -advised to pay attention if your email client changes anything like line -breaks or indentation which could potentially break the patches. - -Expect some delay when you submit your very first patch to -@email{guix-patches@@gnu.org}. You have to wait until you get an -acknowledgement with the assigned tracking number. Future acknowledgements -should not be delayed. - -When a bug is resolved, please close the thread by sending an email to -@email{@var{ISSUE_NUMBER}-done@@debbugs.gnu.org}. - @menu * Configuring Git:: * Sending a Patch Series::