Blob Blame History Raw
Contributing to gfs2-utils
--------------------------

Here are some brief guidelines to follow when contributing to gfs2-utils.

Translations
------------

We use the Zanata translation service:

    https://fedora.zanata.org/project/view/gfs2-utils

See the documentation there for submitting translations.

Patches
-------

We don't dictate any particular coding style but please try to use a style
consistent with the existing code. If in doubt, the Linux kernel coding style
document is a good guideline:

    http://www.kernel.org/doc/Documentation/CodingStyle

We use git for managing our source code and we assume here that you're familiar
with git. Patches should apply cleanly to the latest master branch of
gfs2-utils.git

    https://pagure.io/gfs2-utils

For ease of review and maintenance each of your patches should address a single
issue and if there are multiple issues please consider spreading your work over
several patches. Ideally none of the individual patches should break the build.

We value good commit logs, which should be of the form:

    component: short patch summary

    Longer description wrapped at approx. 72 columns explaining the problem the
    patch addresses and how the patch addresses it.

    Signed-off-by: Your Name <youremail@example.com>

The "component" should be the name of the tool or the part of the code which
the patch touches. As we share a mailing list with several projects it should
make clear that it's a gfs2-utils patch. Some examples:

Bad short logs:

    Fix a bug
    Add a test

Good short logs:

    fsck.gfs2: Fix a null pointer dereference in foo
    gfs2-utils: Add a test for lgfs2_do_stuff

Be sure to reference any relevant bug reports in your long description, e.g.

    Ref: rhbz#012345
    Fixes: rhbz#98765

Please send patches to <cluster-devel@redhat.com>. We recommend using
`git format-patch' to generate patch emails from your commits and `git
send-email' for sending them to the list. See the git documentation for
details.