1
Fork 0
mirror of https://github.com/wlinator/luminara.git synced 2024-10-02 18:03:12 +00:00

Create CONTRIBUTING.md

This commit is contained in:
wlinator 2024-08-03 04:59:28 -04:00
parent 0930c5068f
commit 47b1100f51

44
CONTRIBUTING.md Normal file
View file

@ -0,0 +1,44 @@
# Contributing to Luminara
Thank you for your interest in contributing to Lumi! We welcome contributions from the community to help improve and expand the bot's functionality. Please follow these guidelines when contributing:
## Getting Started
1. **Fork the Repository:** Fork the Luminara repository to your own GitHub account.
2. **Clone Your Fork:** Clone your forked repository to your local machine.
3. **Set Up Development Environment:**
* **Docker:** To run the bot, use this command to run your newly edited code:
```bash
docker compose -f docker-compose.dev.yml up --build
```
* **Poetry:** While developing, it is recommended to install & configure poetry locally:
```bash
poetry install
poetry shell
poetry pre-commit install
```
## Making Changes
1. **Create a Branch:** Create a new branch for your changes.
2. **Code Style:** Adhere to the existing code style and formatting conventions.
3. **Strict Typing:** Always use strict typing (e.g., `str`, `int`, `List[str]`) for better code quality and maintainability.
4. **Pre-Commit Checks:** Before committing, run pre-commit checks to ensure your code passes linting and formatting standards.
5. **Clear Commit Messages:** Write clear and concise commit messages that describe the changes you made.
## Submitting Changes
1. **Create a Pull Request:** Create a pull request (PR) from your branch to the `main` branch of the original repository.
2. **Review:** Your PR will be reviewed by the Sourcery & Lumi maintainers. Address any feedback or requested changes.
3. **Merge:** Once approved, your PR will be merged into the main branch.
## Additional Notes
* **Documentation:** If you add new functionality or change existing behavior, update or add the docstrings accordingly.
Thank you for your contributions!