Updated contributors guide

This commit is contained in:
Michael Boelen 2016-10-28 16:38:09 +02:00
parent 1cb1fc40ca
commit 54fac2141d

View File

@ -1,5 +1,44 @@
# Contributions # Contributions
## Helping out
### Run the latest version from GitHub
Run the tool in debug mode (use lynis audit system --profile developer.prf) and see if it shows any error.
### Report bugs
Create an GitHub issue on the issue tracker
### Suggest changes (pull request)
When you find something that can be improved, fork the project and create a pull request.
### Translations
See the db/languages directory
## Developer Guidelines
To ensure all pull requests can be easily checked and merged, here are some tips:
* Your code should work on other platforms running the bourne shell (/bin/sh), not just BASH.
* Properly document your code where needed. Besides the 'what', focus on explaining the 'why'.
* Check the log information (lynis.log) of your new test or changed code, so that it provides helpful details for others.
## Code Guidelines
### General
Identation should be 4 spaces (no tab character).
### Comments
Comments: use # sign followed by a space. When needed, create a comment block.
Blank lines: allowed, one line maximum
### Functions
All functions use CamelCase to clearly show a difference between shell built-in commands, or external commands.
### Variables
Variables should be capitalized, with underscore as word separator (e.g. PROCESS_EXISTS=1)
## Pull Requests ## Pull Requests
We welcome any contribution to improve Lynis. Contributions to the Lynis project can We welcome any contribution to improve Lynis. Contributions to the Lynis project can
be submitted as a pull request. The upstream project can be found in our [GitHub repository](https://github.com/CISOfy/lynis). be submitted as a pull request. The upstream project can be found in our [GitHub repository](https://github.com/CISOfy/lynis).
@ -19,35 +58,15 @@ to this repository, you agree that you:
If you have questions regarding development, send us an e-mail at [lynis-dev](mailto:lynis-dev@cisofy.com) If you have questions regarding development, send us an e-mail at [lynis-dev](mailto:lynis-dev@cisofy.com)
## Unlimited Rights ## Unlimited Rights
Our project is licensed under GPLv3. By providing a contribution to the project, it Our project is licensed under GPLv3. By providing a contribution to the project,
will be used for the purpose of the project. Unlimited rights includes the rights to it will be used for the purpose of the project. Unlimited rights includes the
use, modify, reproduce, release, perform, display, or disclose computer software or rights to use, modify, reproduce, release, perform, display, or disclose computer
computer software documentation in whole or in part, in any manner and for any software or computer software documentation in whole or in part, in any manner
purpose whatsoever, and to have or authorize others to do so. and for any purpose whatsoever, and to have or authorize others to do so.
If you want to be named in as a contributor in the CONTRIBUTOR file, then include If you want to be named in as a contributor in the CONTRIBUTOR file, then include
this notition in your pull request. Preferred format: Full Name, with optional the this notition in your pull request. Preferred format: Full Name, and your e-mail
company name and/or your e-mail address). address).
## Developer Guidelines
To ensure all pull requests can be easily checked and merged, here are some tips:
* Your code should work on other platforms running the bourne shell (/bin/sh), not just BASH.
* Properly document your code where needed. Besides the 'what', focus on explaining the 'why'.
* Check the log information (lynis.log) of your new test or changed code, so that it provides helpful details for others.
## Code Guidelines
### General
Identation should be 4 spaces (no tab character).
### Comments
Comments: use # sign followed by a space. When needed, create a comment block.
Blank lines: allowed, one line maximum
### Functions
All functions use CamelCase to clearly show a difference between shell built-in commands, or external commands.
### Variables
Variables should be capitalized, with underscore as word separator (e.g. PROCESS_EXISTS=1)