aboutsummaryrefslogtreecommitdiffstats
path: root/CONTRIBUTING.d
AgeCommit message (Collapse)AuthorFilesLines
2025-11-10CONTRIBUTING.d/ai: Add guidelines banning AI for contributingAlejandro Colomar1-0/+63
This policy is based on the Gentoo policy (see link below). However, I've modified our text to be more restrictive. Link: <https://wiki.gentoo.org/wiki/Project:Council/AI_policy> Reviewed-by: Carlos O'Donell <carlos@redhat.com> Cc: Collin Funk <collin.funk1@gmail.com> Cc: Sam James <sam@gentoo.org> Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-02-10CONTRIBUTING.d/style/c: Add coding style for the example programsAlejandro Colomar1-0/+128
Personally, I prefer tabs for actual programming. But for manual pages, we can live with 4 spaces for $reasons. Reported-by: "G. Branden Robinson" <branden@debian.org> Reported-by: Jason Yundt <jason@jasonyundt.email> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2025-02-10CONTRIBUTING.d/: Move style to style/manAlejandro Colomar1-0/+0
This makes room for adding <style/c>, a C coding style guide. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-19CONTRIBUTING.d/patches/subject: Use the full path alwaysAlejandro Colomar1-7/+4
This is easier to do, since auto-completion will do it. Also, it's more consistent. I started using full paths a few commits ago. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-16CONTRIBUTING.d/git: mkdir(1) parent directory before writing to fileAlejandro Colomar1-0/+1
Reported-by: Elliott Hughes <enh@google.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-12-05CONTRIBUTING.d/patches/description: Add link to history of inter-sentence spaceAlejandro Colomar1-1/+3
Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-07CONTRIBUTING.d/lint: 'make build' does not build everything anymoreAlejandro Colomar1-2/+2
Fixes: 082547cb6fbb ("share/mk/: Reduce the work of 'make && make install'") Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/patches: Patches should contain a description.Alejandro Colomar1-0/+4
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/patches: Minor tweaks after splitting the fileAlejandro Colomar1-10/+9
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/sendmail: Add file documenting how to send patchesAlejandro Colomar2-48/+51
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/base: Add file documenting the base commit of patch setsAlejandro Colomar2-3/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/range-diff: Add file documenting the range-diff ↵Alejandro Colomar2-31/+37
between patch revisions Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/diff: Add file documenting the diff of a patchAlejandro Colomar2-4/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/description: Add file documenting the description of ↵Alejandro Colomar2-39/+55
a patch Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/subject: Add file documenting the subject of a patchAlejandro Colomar2-21/+41
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-06CONTRIBUTING.d/patches/patches: Move file into a subdirectoryAlejandro Colomar1-0/+0
This is in preparation of a split that will happen soon. The file has grown too much, and I will split it in smaller ones that cover different aspects of patches. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-04CONTRIBUTING.d/git: Specify format.thread=shallowAlejandro Colomar1-1/+1
Setting it to true is equivalent to "shallow", but set it explicitly. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03CONTRIBUTING.d/git: Recommend merge.verifySignatures=trueAlejandro Colomar1-0/+5
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-03CONTRIBUTING.d/git: Sort alphabeticallyAlejandro Colomar1-6/+6
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01CONTRIBUTING.d/git: Recommend am.messageid=trueAlejandro Colomar1-0/+6
This is useful for maintainers. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-11-01CONTRIBUTING.d/patches: Documentation patches should be sent alongside the ↵Alejandro Colomar1-0/+20
features Link: <https://lwn.net/Articles/989380/> Cc: Jiri Olsa <jolsa@kernel.org> Cc: Günther Noack <gnoack@google.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-08-31CONTRIBUTING.d/git: Recommend format.thread=trueAlejandro Colomar1-0/+4
This generates patch sets as threads, with a Message-ID pre-set for the first mail. Cc: "G. Branden Robinson" <branden@debian.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-15CONTRIBUTING.d/patches: Specify the git repository when mentioning commitsAlejandro Colomar1-1/+1
It might be linux.git, glibc.git, or some other, so let's clarify. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-15CONTRIBUTING.d/patches: wfixAlejandro Colomar1-3/+3
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-15CONTRIBUTING.d/patches: Clarify that [PATCH v1] is also validAlejandro Colomar1-3/+4
And actually, preferable. Thus, use it in all examples. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-15CONTRIBUTING.d/patches: Say [PATCH] instead of [patch]Alejandro Colomar1-3/+3
Patches are usually generated by git-format-patch(1), which says [PATCH], not [patch]. To avoid confusion, use the same form here. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-06-15CONTRIBUTING.d/mail: Remove broken linksAlejandro Colomar1-3/+0
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-05-04CONTRIBUTING.d/*: Add instructions for configuring git(1) for this projectAlejandro Colomar2-21/+46
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-04-30CONTRIBUTING.d/patches: Please provide a git-range-diff(1)Alejandro Colomar1-0/+30
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-04-30CONTRIBUTING.d/patches: Add git-send-email(1) configuration for To and CcAlejandro Colomar1-0/+7
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-04-29CONTRIBUTING.d/mail: Recommend specific mutt(1) configAlejandro Colomar1-0/+6
We want protected headers too. Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-04-27CONTRIBUTING.d/: Clarify how to send patches with git-send-email(1)Alejandro Colomar2-9/+26
Cc: Simon Barth <simon.barth@gmx.de> Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-26CONTRIBUTING.d/lint: Rewrite now that we have $SKIP_XFAILAlejandro Colomar1-27/+27
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-03CONTRIBUTING, CONTRIBUTING.d/mail: Split file, and rewrite CONTRIBUTING as ↵Alejandro Colomar1-0/+67
an intro CONTRIBUTING is now an intro to all the files in CONTRIBUTING.d/ Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-03CONTRIBUTING, CONTRIBUTING.d/patches: Split CONTRIBUTING fileAlejandro Colomar1-0/+94
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-03CONTRIBUTING, CONTRIBUTING.d/style: Split CONTRIBUTING fileAlejandro Colomar1-0/+21
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-03CONTRIBUTING, CONTRIBUTING.d/lint: Split CONTRIBUTING fileAlejandro Colomar1-0/+40
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-03CONTRIBUTING, CONTRIBUTING.d/external_pages: Split CONTRIBUTING fileAlejandro Colomar1-0/+17
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2024-02-03CONTRIBUTING, CONTRIBUTING.d/bugs, README: Split CONTRIBUTING fileAlejandro Colomar1-0/+28
Signed-off-by: Alejandro Colomar <alx@kernel.org>
generated by cgit 1.2.3-korg (git 2.43.0) at 2025-11-30 03:20:07 +0000