From e0d9b8c57c3b703737e1e9efd2350027ebc3ca1b Mon Sep 17 00:00:00 2001
From: Igor Benav <43156212+igorbenav@users.noreply.github.com>
Date: Sun, 21 Jan 2024 00:07:04 -0300
Subject: [PATCH] Create CONTRIBUTING.md

---
 CONTRIBUTING.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..ad28916
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,73 @@
+# Contributing to FastAPI-boilerplate
+
+Thank you for your interest in contributing to FastAPI-boilerplate! This guide is meant to make it easy for you to get started.
+
+## Setting Up Your Development Environment
+
+### Cloning the Repository
+Start by forking and cloning the FastAPI-boilerplate repository:
+
+```sh
+git clone https://github.com/igorbenav/FastAPI-boilerplate.git
+```
+
+### Using Poetry for Dependency Management
+FastAPI-boilerplate uses Poetry for managing dependencies. If you don't have Poetry installed, follow the instructions on the [official Poetry website](https://python-poetry.org/docs/).
+
+Once Poetry is installed, navigate to the cloned repository and install the dependencies:
+```sh
+cd FastAPI-boilerplate
+poetry install
+```
+
+### Activating the Virtual Environment
+Poetry creates a virtual environment for your project. Activate it using:
+
+```sh
+poetry shell
+```
+
+## Making Contributions
+
+### Coding Standards
+- Follow PEP 8 guidelines.
+- Write meaningful tests for new features or bug fixes.
+
+### Testing with Pytest
+FastAPI-boilerplate uses pytest for testing. Run tests using:
+```sh
+poetry run pytest
+```
+
+### Linting
+Use mypy for type checking:
+```sh
+mypy src
+```
+
+Use ruff for style:
+```sh
+ruff check --fix
+ruff format
+```
+
+Ensure your code passes linting before submitting.
+
+## Submitting Your Contributions
+
+### Creating a Pull Request
+After making your changes:
+
+- Push your changes to your fork.
+- Open a pull request with a clear description of your changes.
+- Update the README.md if necessary.
+
+
+### Code Reviews
+- Address any feedback from code reviews.
+- Once approved, your contributions will be merged into the main branch.
+
+## Code of Conduct
+Please adhere to our [Code of Conduct](CODE_OF_CONDUCT.md) to maintain a welcoming and inclusive environment.
+
+Thank you for contributing to FastAPI-boilerplate🚀