First, thank you for stopping by as you consider contributing to C-Menu! 🎉
All types of contributions are welcome: reporting bugs, suggesting features, writing documentation, or fixing code. The highest compliment you can give to an open source project is to get involved. This guide will walk you through the process of contributing to C-Menu, ensuring that your efforts are recognized and appreciated.
📜 Code of Conduct
By participating in this project, you agree to abide by our Code of Conduct. Please report any unacceptable behavior to billx.nosp@m.wall.nosp@m.er@gm.nosp@m.ail..nosp@m.com.
🐛 How to Report a Bug
Before submitting a bug report, please search our Issues Tab to see if the problem has already been reported.
If it hasn't, please open a new issue and include:
- A clear summary of the problem in the title.
- Steps to reproduce the behavior.
- Expected vs. actual results.
- Screenshots or GIFs if the bug is visual.
- Your environment details (Operating System, browser, language/framework versions).
💡 How to Suggest a Feature
We use GitHub Issues to track feature requests. To suggest an enhancement:
- Check if the feature has already been proposed in the existing issues.
- Open a new issue and select the "Feature Request" template (if available).
- Explain the use case and why this feature would be useful to most users.
- Describe how the feature should work or provide mockup ideas.
🛠️ How to Submit Code (Pull Request Process)
To make code or documentation changes, follow these steps:
1. Set Up Your Environment
- Fork the repository to your own GitHub account.
Clone your fork locally:
git clone https://github.com
Create a new branch for your work. Keep the name short and descriptive (e.g., fix-login-validation or feat-dark-mode):
git checkout -b your-branch-name
2. Make Your Changes
- Adhere to the project's existing code styling and standards.
- Write clean, commented, and readable code.
- Add unit or integration tests for any new logic.
- Ensure all existing tests still pass.
3. Commit and Push
- Write clear, concise commit messages in the imperative mood (e.g., Add user authentication module).
- Push the changes to your remote fork:
git push origin your-branch-name
4. Open a Pull Request
- Navigate back to the original repository on GitHub.
- Click Compare & pull request.
- Fill out the Pull Request (PR) template:
- Explain what changed and why.
- Link any relevant issues (e.g., Closes #123).
- Wait for the maintainers to review your code. Be open to constructive feedback!
🚀 Recognition
Contributors are the lifeblood of open source. Your profile will be added to our contributors list in the README.md once your pull request is merged!