Contributing

Thanks for considering contributing to PHH file format specification! Your contributions are greatly appreciated, and help make PHH file format specification a better tool for everyone in the Poker AI and research communities.

Setting up Your Development Environment

1. Fork the PHH file format specification repository on GitHub.

2. Clone your fork locally: git clone git@github.com:username/phh-std.git

3. Setup virtual environment: python -m venv venv

4. Activate the virtual environment: source venv/bin/activate

5. Install requirements: pip install -r requirements.txt

6. Create a branch for your changes: git checkout -b branch-name

Making Changes

When making changes, please follow these guidelines:

• Always write example code in compliance with PEP8.

• Test the example code you added/changed, and make sure they are corrrect before submitting a pull request.

• Document your changes in the code and update the README file if necessary.

• After making changes, please validate your changes by building the docs with the following command: make html

Submitting a Pull Request

1. Commit your changes: git commit -am 'Add some feature'

2. Push to the branch: git push origin branch-name

3. Submit a pull request to the main branch in the PHH file format specification repository.

After Your Pull Request Is Merged

After your pull request is merged, you can safely delete your branch and pull the changes from the main repository:

• Delete the remote branch on GitHub: git push origin --delete branch-name

• Check out the main branch: git checkout main

• Delete the local branch: git branch -d branch-name

• Update your main with the latest upstream version: git pull upstream main