view CONTRIBUTING @ 1305:e74729772b75 draft default tip

objstore: add a per-page lock Aside from just adding the lock to the structure, this commit also adds the appropriate page_{lock,unlock} calls to the cache code and replaces an open-coded free with a call to free_page. Signed-off-by: Josef 'Jeff' Sipek <jeffpc@josefsipek.net>
author Josef 'Jeff' Sipek <jeffpc@josefsipek.net>
date Thu, 01 Feb 2024 11:57:28 -0500
parents dcc98b9f5911
children
line wrap: on
line source

There's not much to helping develop Nomad.  Most of the following has been
adapted, or blatantly stolen from the Linux kernel's
Documentation/SubmittingPatches file. :)

1) Hack on the code a bit

2) Make a patch:

Use "diff -up" or "diff -uprN" to create patches.  Or simply use Mercurial
to create patches against the latest version.

3) Describe the changes:

If you generated a patch using diff, make sure you include a description of
your changes at the beginning of the patch. If you used Mercurial, make sure
the Mercurial commit message contains a good description of the changes.

Prefix the email's subject with "[PATCH]".  For example:
  Subject: [PATCH] fix important bug

4) Send the patches to the mailing list (XXX).

5) Sign your work:

To improve tracking of who did what, we are following a "sign-off" procedure
similar to the Linux kernel.

The sign-off is a simple line at the end of the explanation for the
patch, which certifies that you wrote it or otherwise have the right to
pass it on as a open-source patch.  The rules are pretty simple: if you
can certify the below:

        Developer's Certificate of Origin 1.1

        By making a contribution to this project, I certify that:

        (a) The contribution was created in whole or in part by me and I
            have the right to submit it under the open source license
            indicated in the file; or

        (b) The contribution is based upon previous work that, to the best
            of my knowledge, is covered under an appropriate open source
            license and I have the right under that license to submit that
            work with modifications, whether created in whole or in part
            by me, under the same open source license (unless I am
            permitted to submit under a different license), as indicated
            in the file; or

        (c) The contribution was provided directly to me by some other
            person who certified (a), (b) or (c) and I have not modified
            it.

	(d) I understand and agree that this project and the contribution
	    are public and that a record of the contribution (including all
	    personal information I submit with it, including my sign-off) is
	    maintained indefinitely and may be redistributed consistent with
	    this project or the open source license(s) involved.

then you just add a line saying

	Signed-off-by: Random J Developer <random@developer.example.org>

using your real name (sorry, no pseudonyms or anonymous contributions.)