|
| 1 | +# Contributing to Webtricks |
| 2 | + |
| 3 | +Thank you for considering contributing to **Webtricks**! By contributing, you help make this project more robust, efficient, and accessible to developers worldwide. Please follow these guidelines to ensure a smooth and effective collaboration. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## How to Contribute |
| 8 | + |
| 9 | +### Reporting Issues |
| 10 | +If you encounter bugs, have feature requests, or need clarification, please: |
| 11 | +1. Check the [issues page](https://github.com/TheCodeRaccoons/WebTricks/issues) to see if the issue has already been reported. |
| 12 | +2. Open a new issue if necessary: |
| 13 | + - Provide a clear and descriptive title. |
| 14 | + - Include steps to reproduce the issue (if applicable). |
| 15 | + - Attach screenshots, code snippets, or relevant files to help us understand the problem. |
| 16 | + |
| 17 | +### Suggesting Features |
| 18 | +Have a cool idea to improve **Webtricks**? Open an issue and tag it as a `feature request`. Please include: |
| 19 | +- A brief explanation of your idea. |
| 20 | +- Why it would be useful for other developers. |
| 21 | +- If possible, examples of similar features or inspiration. |
| 22 | + |
| 23 | +--- |
| 24 | + |
| 25 | +## Code Contributions |
| 26 | + |
| 27 | +### Getting Started |
| 28 | +1. **Fork the Repository**: |
| 29 | + - Go to [Webtricks GitHub Repository](https://github.com/TheCodeRaccoons/WebTricks). |
| 30 | + - Click `Fork` to create your copy of the repository. |
| 31 | + |
| 32 | +2. **Clone Your Fork**: |
| 33 | + ```bash |
| 34 | + git clone https://github.com/your-username/webtricks.git |
| 35 | + cd webtricks |
| 36 | + ``` |
| 37 | + |
| 38 | +3. **Create a Branch:** |
| 39 | + ```bash |
| 40 | + git checkout -b feature/your-feature-name |
| 41 | + ``` |
| 42 | + or |
| 43 | + ```bash |
| 44 | + git checkout -b fix/your-fix-name |
| 45 | + ``` |
| 46 | +4. **Make Your Changes:** |
| 47 | + - Follow the coding style and structure already established. |
| 48 | + - Test your changes locally before committing. |
| 49 | + |
| 50 | +6. **Commit Your Changes:** |
| 51 | + ```bash |
| 52 | + git add . |
| 53 | + git commit -m "Description of your changes" |
| 54 | + ``` |
| 55 | + |
| 56 | +7. **Push to Your Fork:** |
| 57 | + ```bash |
| 58 | + git push origin feature/your-feature-name |
| 59 | + ``` |
| 60 | + |
| 61 | +8. **Create a Pull Request:** |
| 62 | + - Go to your fork on GitHub and click Compare & pull request. |
| 63 | + - Provide a clear description of your changes and link any related issues. |
| 64 | + - Provide a working example if it is a new feature or a codepen link / webflow.io link of the functionality working properly |
| 65 | + |
| 66 | +--- |
| 67 | + |
| 68 | +## Development Guidelines |
| 69 | +Code Standards |
| 70 | + - Use vanilla JavaScript and avoid adding external dependencies. |
| 71 | + - Follow consistent naming conventions for attributes and variables. |
| 72 | + - Ensure clear and concise documentation for new features. |
| 73 | + |
| 74 | +Testing |
| 75 | + - Test your changes thoroughly before submitting. |
| 76 | + - Add examples in the examples/ folder for any new functionality. |
| 77 | +--- |
| 78 | +## Join the Discussion |
| 79 | +Participate in ongoing discussions in [GitHub Discussions](https://github.com/TheCodeRaccoons/WebTricks/discussions). |
| 80 | +Share your feedback, ideas, and improvements. |
| 81 | + |
| 82 | + |
| 83 | +Thank you for helping make Webtricks better! |
0 commit comments