Welcome to the ShashChess project! We are excited that you are interested in contributing. This document outlines the guidelines and steps to follow when making contributions to ShashChess.
In case you do not have a C++ compiler installed, you can follow the instructions from our wiki.
If you find a bug, please open an issue on the issue tracker. Be sure to include relevant information like your operating system, build environment, and a detailed description of the problem.
Please note that ShashChess's development is not focused on adding new features. Thus any issue regarding missing features will potentially be closed without further discussion.
-
Functional changes need to be tested on fishtest. See Creating my First Test for more details. The accompanying pull request should include a link to the test results and the new bench.
-
Non-functional changes (e.g. refactoring, code style, documentation) do not need to be tested on fishtest, unless they might impact performance.
-
Provide a clear and concise description of the changes in the pull request description.
First time contributors should add their name to AUTHORS.
ShashChess's development is not focused on adding new features. Thus any pull request introducing new features will potentially be closed without further discussion.
Changes to ShashChess C++ code should respect our coding style defined by
.clang-format. You can format your changes by running
make format. This requires clang-format version 18 to be installed on your system.
For experienced Git users who frequently use git blame, it is recommended to configure the blame.ignoreRevsFile setting. This setting is useful for excluding noisy formatting commits.
git config blame.ignoreRevsFile .git-blame-ignore-revs- Join the ShashChess discord to discuss ideas, issues, and development.
- Participate in the ShashChess GitHub discussions for broader conversations.
By contributing to ShashChess, you agree that your contributions will be licensed under the GNU General Public License v3.0. See Copying.txt for more details.
Thank you for contributing to ShashChess and helping us make it even better!