Add CONTRIBUTING guidelines

Author: DiogoRibeiro7

CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing to gen_surv
+
+Thank you for taking the time to contribute to **gen_surv**! This document provides a brief overview of the recommended workflow for feature requests and pull requests.
+
+## Getting Started
+
+1. Fork the repository and create your feature branch from `main`.
+2. Install dependencies with `poetry install`.
+3. Ensure the test suite passes with `poetry run pytest`.
+4. If you add a feature or fix a bug, update `CHANGELOG.md` accordingly.
+
+## Version Consistency
+
+Releases are tagged in Git. Before creating a release, verify that the version declared in `pyproject.toml` matches the latest Git tag:
+
+```bash
+python scripts/check_version_match.py
+```
+
+The CI workflow `version-check.yml` runs this same script on pull requests to `main`.
+
+## Submitting Changes
+
+1. Commit your changes with clear messages.
+2. Push to your branch and open a pull request.
+3. Ensure your PR description explains the motivation and summarizes your changes.
+
+We appreciate your contributions and feedback!

README.md

@@ -103,3 +103,7 @@ This project uses Git tags to manage releases. A GitHub Actions workflow
 (`version-check.yml`) verifies that the version declared in `pyproject.toml`
 matches the latest Git tag. If they diverge, the workflow fails and prompts a
 correction before merging.
+
+## 🤝 Contributing
+
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on setting up your environment, running tests, and submitting pull requests.