Skip to content

Latest commit

 

History

History
80 lines (53 loc) · 3.3 KB

CONTRIBUTING.md

File metadata and controls

80 lines (53 loc) · 3.3 KB

Contributing to an AppSecDev project

We welcome contributions but request that you follow these guidelines.

Reporting a bug

Please raise any bug reports on the project's issue tracker. Be sure to search the list to see if your issue has already been raised.

A good bug report is one that make it easy for us to understand what you were trying to do and what went wrong. Also, provide as much context as possible so we can try to recreate the issue.

New features

Please raise any new feature requests on the project's issue tracker.

Pull requests

Changes to existing code

If you want to raise a pull request with a new feature, a bug fix, or a refactoring of existing code, make sure to open an issue in the project's issue tracker first before engaging in serious development work. This will start a discussion and help in accepting the pull request.

Coding standards

Please ensure you follow the coding standards used throughout the existing code base.

Contributor License Agreement

In order for us to accept pull requests, you must declare that you wrote the code or, at least, have the right to contribute it to the repo under the open source licence of the project in the repo.

  1. Read this (from developercertificate.org):
Developer Certificate of Origin
Version 1.1

Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
660 York Street, Suite 102,
San Francisco, CA 94110 USA

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.


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.
  1. If you can certify that it is true, sign off your git commit with a message like this:
Signed-off-by: Your Name <[email protected]>

You must use your real name (no pseudonyms or anonymous contributions, sorry).

Instead of typing that in every git commit message, your Git tools might let you automatically add the details for you. If you configure them to do that, when you issue the git commit command, just add the -s option.

If you are an IBMer, please contact us directly as the contribution process is slightly different.