Skip to content

Commit e21edec

Browse files
authored
Create CONTRIBUTING.md
1 parent a37e338 commit e21edec

File tree

1 file changed

+89
-0
lines changed

1 file changed

+89
-0
lines changed

CONTRIBUTING.md

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
# Contributing to fastapi-user-authentication
2+
3+
Thank you for your interest in contributing! We welcome contributions to improve our project, including bug fixes, new features, documentation updates, and more.
4+
5+
## Table of Contents
6+
7+
- [Getting Started](#getting-started)
8+
- [Development Workflow](#development-workflow)
9+
- [Guidelines](#guidelines)
10+
- [Submitting Contributions](#submitting-contributions)
11+
- [Code of Conduct](#code-of-conduct)
12+
- [Contact](#contact)
13+
14+
## Getting Started
15+
16+
1. **Fork the Repository**: Start by forking the repository to your GitHub account.
17+
2. **Clone Your Fork**:
18+
```bash
19+
git clone https://github.com/VannySothea/fastapi-user-authentication.git
20+
cd fastapi-user-authentication
21+
```
22+
3. **Install Dependencies**:
23+
Ensure you have Python 3.12+ installed. Install the required dependencies:
24+
```bash
25+
pip install -r requirements.txt
26+
```
27+
28+
4. **Set Up Environment**: Configure the necessary environment variables:
29+
- Copy the `.env.example` file to `.env` and update values as needed.
30+
31+
## Development Workflow
32+
33+
1. **Create a Branch**: Use a descriptive branch name for your feature or fix.
34+
```bash
35+
git checkout -b feature/your-feature-name
36+
```
37+
38+
2. **Make Changes**: Implement your changes following the project's coding standards.
39+
40+
3. **Run Tests**: (Once tests are available) Run tests to ensure your changes don't break existing functionality.
41+
```bash
42+
# Example command to run tests
43+
pytest
44+
```
45+
46+
4. **Commit Changes**: Write clear, descriptive commit messages.
47+
```bash
48+
git add .
49+
git commit -m "Add description of changes"
50+
```
51+
52+
5. **Push to Your Fork**:
53+
```bash
54+
git push origin feature/your-feature-name
55+
```
56+
57+
6. **Create a Pull Request (PR)**: Go to the repository on GitHub and create a PR from your branch.
58+
59+
## Guidelines
60+
61+
### Code Style
62+
63+
- Follow **PEP 8** guidelines.
64+
- Use descriptive variable names and comments where necessary.
65+
- Ensure consistent formatting, especially in Python files.
66+
67+
### Documentation
68+
69+
- Update the documentation for any new features, modules, or functions you add.
70+
- Include code comments and docstrings for complex logic.
71+
72+
### Commit Messages
73+
74+
- Use descriptive messages to explain the "why" behind each change.
75+
- Use the format: `[Type]: Description` (e.g., `feat: add role-based access control`).
76+
77+
### Pull Request Checklist
78+
79+
- Ensure your PR description explains what changes are made and why.
80+
- Reference any relevant issues by including the issue number.
81+
- Address any feedback from code reviewers.
82+
83+
## Code of Conduct
84+
85+
This project adheres to a [Code of Conduct](./CODE_OF_CONDUCT.md). By participating, you agree to uphold these standards.
86+
87+
## Contact
88+
89+
If you have any questions or need further guidance, feel free to reach out by creating an issue in the repository or contacting the maintainers.

0 commit comments

Comments
 (0)