guix/doc
Christopher Baines 4955589f2f
doc: Make changes to the handling of branches.
Require that you create a "Request to merge" issue when you create a branch,
rather than when you wish to merge it.  This should help avoid this step being
missed.

Also, add information on how to manage these branches:

 1. Suggest creating the branch from patches, rather than having a stateful
 branch, since this should help to reduce complexity and avoid merges.

 2. Require that branches don't have unnecessary changes, since this increases
 the risks of conflicts with other branches.

 3. Suggest that the branch not be stateful, and it's just a combination of
 patches.

 4. Suggest avoiding merges since these create a more complicated Git history.

 5. Suggest that the branch be up to date before merging, as this helps avoid
 the combination of master plus the branch differing significantly from the
 branch alone.

 6. Document how to manage branches without commit access.

Finally, require that the branch be deleted once they're merged.  This
prepares for the branch being created again.

* doc/contributing.texi (Managing Patches and Branches): Make changes to the
handling of branches.

Change-Id: Ib9419c6df94f485475bd6f147e82ea254e76cec2
2024-05-22 14:31:01 +01:00
..
images doc: Use "dejavu sans" instead of "Helvetica" or "sans" in dot images. 2024-04-14 10:29:07 +02:00
build.scm nls: Update translations. 2024-04-01 14:09:20 +02:00
contributing.texi doc: Make changes to the handling of branches. 2024-05-22 14:31:01 +01:00
environment-gdb.scm doc: Update GDB "guix shell" example to use autoconf-2.69 2023-07-18 00:41:15 +02:00
fdl-1.3.texi
guix-cookbook.texi doc: cookbook: Fix overlong lines. 2024-05-19 19:09:40 +02:00
guix.texi import: Add binary npm importer. 2024-05-19 16:05:00 +02:00
he-config-bare-bones.scm doc: Update example of a minimalistic home environment. 2022-06-10 22:42:49 +02:00
htmlxref.cnf nls: Update translations. 2024-04-01 14:09:20 +02:00
local.mk Revert "maint: Generate 'doc/version.texi' reproducibly." 2024-04-19 16:45:41 +02:00
package-hello.json import: Do not return package name with json importer. 2024-02-23 19:02:55 +01:00
package-hello.scm