Please use the following template to submit a pull request, filling in at least the "Text for release notes" and/or "Further details". Thank you!
If this pull request shall not be mentioned in the release notes
(to be distributed in the file CHANGES.md
),
please add the label release notes: not needed
.
Otherwise, please proceed in one of the following ways:
-
Choose a title that can serve as text for the release notes, and add the label
release notes: use title
. -
Put the text for the release notes here, that is, between the markers
Text for release notes
and(End of text for release notes)
.
The first variant is recommended whenever the text for release notes is suitable as title.
In both cases, please follow the style of the GAP CHANGES.md
file
in the root directory.
In particular, please surround the names of GAP functions with backquotes.
If necessary, please provide further details here.
- proper formatting
If your code contains kernel C code, run clang-format
on it; the
simplest way is to use git clang-format
, e.g. like this (don't
forget to commit the resulting changes):
git clang-format $(git merge-base HEAD master)
-
usage of relevant labels
- either
release notes: not needed
orrelease notes: to be added
- at least one of the labels
bug
orenhancement
ornew feature
- for changes meant to be backported to
stable-4.X
add thebackport-to-4.X
label - consider adding any of the labels
build system
,documentation
,kernel
,library
,tests
- either
-
runnable tests
-
lines changed in commits are sufficiently covered by the tests
-
adequate pull request title
-
well formulated text for release notes
-
relevant documentation updates
-
sensible comments in the code