mirror of
https://github.com/CISOfy/lynis.git
synced 2025-07-30 17:24:32 +02:00
Updated contributors guide
This commit is contained in:
parent
1cb1fc40ca
commit
54fac2141d
@ -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)
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user