2019-08-08 18:34:14 +02:00
2025-01-23 05:10:12 +01:00
### Contributing / participating
2019-08-08 18:34:14 +02:00
2025-01-23 05:10:12 +01:00
Contributing / participating is always welcome!
2019-08-08 18:34:14 +02:00
2025-01-16 16:36:37 +01:00
Please note the following:
2019-08-08 18:34:14 +02:00
2025-01-23 17:37:32 +01:00
* Please read the [coding convention ](https://github.com/testssl/testssl.sh/blob/3.2/Coding_Convention.md ).
* If you have something new and/or bigger which you like to contribute, better open an issue first before you get frustrated.
* Please one pull request per feature or bug fix or improvement. Please do not mix issues.
2025-01-23 17:41:36 +01:00
* Documentation pays off in the long run. So please your document your code and the pull request and/or commit message.
2020-01-24 11:33:11 +01:00
* Please test your changes thoroughly as reliability is important for this project. You may want to check different servers with different settings.
2025-01-23 17:41:36 +01:00
* GitHub actions are running automatically when anything is committed. You should see any complains. Beforehand you can check with `prove -v` from the "root dir" of this project.
2025-01-23 17:37:32 +01:00
* If it's a new feature, please consider writing a unit test for it. You can use e.g. `t/10_baseline_ipv4_http.t` or `t/61_diff_testsslsh.t` as a template. The general documentation for [Test::More ](https://perldoc.perl.org/Test/More.html ) is a good start.
2025-01-16 16:36:37 +01:00
* If it's a new feature, it would need to be documented in the appropriate section in `help()` and in `~/doc/testssl.1.md`
2019-08-08 18:34:14 +02:00
2025-01-23 17:41:36 +01:00
If you're interested in contributing and wonder how you can help, you can search for different tags in the issues (somewhat increasing degree of difficulty):
2025-01-23 17:37:32 +01:00
* [documentation ](https://github.com/testssl/testssl.sh/issues?q=is:issue%20state:open%20label:documentation )
* [good first issue ](https://github.com/testssl/testssl.sh/issues?q=is:issue%20state:open%20label:%22good%20first%20issue%22 )
* [help wanted ](https://github.com/testssl/testssl.sh/issues?q=is:issue%20state:open%20label:%22help%20wanted%22 )
* [for grabs ](https://github.com/testssl/testssl.sh/issues?q=is:issue%20state:open%20label:%22good%20first%20issue%22 )
For questions just open an issue. Thanks for reading this!