Create CONTRIBUTING.md
This commit is contained in:
committed by
GitHub
parent
39f6cea6eb
commit
ba2d005421
@@ -0,0 +1,98 @@
|
|||||||
|
# Contributing to Warlock-Studio
|
||||||
|
|
||||||
|
🎉 Thank you for your interest in contributing to **Warlock-Studio**! This project thrives with the help of developers, testers, designers, and users like you.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Ways to Contribute
|
||||||
|
|
||||||
|
There are many ways you can help:
|
||||||
|
|
||||||
|
- 📦 **Feature Development** — Add new functionalities or improve existing ones.
|
||||||
|
- 🐛 **Bug Fixes** — Squash those pesky bugs.
|
||||||
|
- 📝 **Documentation** — Improve README, usage guides, or internal comments.
|
||||||
|
- 🧪 **Testing** — Help us catch edge cases and improve stability.
|
||||||
|
- 💡 **Ideas & Feedback** — Suggest improvements or report issues.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
### 1. Fork the Repository
|
||||||
|
|
||||||
|
Click the `Fork` button at the top right of this repo to create your own copy.
|
||||||
|
|
||||||
|
### 2. Clone Your Fork
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/YOUR-USERNAME/Warlock-Studio.git
|
||||||
|
cd Warlock-Studio
|
||||||
|
````
|
||||||
|
|
||||||
|
### 3. Create a New Branch
|
||||||
|
|
||||||
|
Name your branch clearly and descriptively:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git checkout -b fix-ui-overflow
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Make Your Changes
|
||||||
|
|
||||||
|
Work your magic! Make sure to follow the existing code style and structure.
|
||||||
|
|
||||||
|
### 5. Test Your Changes
|
||||||
|
|
||||||
|
Ensure that your changes don’t break existing functionality.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Commit Guidelines
|
||||||
|
|
||||||
|
* Write clear, concise commit messages (e.g., `fix: prevent UI overflow on resize`).
|
||||||
|
* Group related changes into a single commit when possible.
|
||||||
|
* Use [Conventional Commits](https://www.conventionalcommits.org/) format if you're comfortable.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Pull Requests
|
||||||
|
|
||||||
|
1. Push your branch:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git push origin fix-ui-overflow
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Open a Pull Request against the `main` branch on this repo.
|
||||||
|
3. Include a clear description of your changes and reference any related issues (e.g., `Fixes #12`).
|
||||||
|
4. Be open to feedback! We may suggest improvements or ask for changes.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Code Style
|
||||||
|
|
||||||
|
* Use consistent formatting and indentation.
|
||||||
|
* Comment your code when necessary for clarity.
|
||||||
|
* Avoid hardcoding paths—use relative paths and config values where possible.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
Warlock-Studio integrates with:
|
||||||
|
|
||||||
|
* [MedIA-Witch](https://github.com/Ivan-Ayub97/MedIA-Witch)
|
||||||
|
* [MedIA-Wizard](https://github.com/Ivan-Ayub97/MedIA-Wizard)
|
||||||
|
* AI models like Real-ESRGAN, Waifu2x, Anime4K, etc.
|
||||||
|
|
||||||
|
Make sure to test your changes across common workflows.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Need Help?
|
||||||
|
|
||||||
|
Feel free to reach out by [email](mailto:negroayub97@gmail.com) or open a [discussion](https://github.com/Ivan-Ayub97/Warlock-Studio/discussions) if you're unsure where to start.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Thanks for making Warlock-Studio better! 🧙♂️✨
|
||||||
Reference in New Issue
Block a user