Skip to content

Commit 86b262f

Browse files
authored
Merge pull request #21 from TheCodeRaccoons/Documentation-and-project-setup
Documentation and project setup
2 parents 46ef20c + f4fdcbc commit 86b262f

17 files changed

Lines changed: 439 additions & 134 deletions

.github/PULL_REQUEST_TEMPLATE/NEW_FEATURE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
<!-- Tick the checkboxes to ensure you've done everything correctly -->
44
- [ ] PR does not match another non-stale PR currently opened
5-
- [ ] PR name matches the format *[ feature ]: <i>Feature Name</i> (<i>versions separated by comma</i>)*. More details [here](https://github.com/TheCodeRaccoons/WebflowTrickery/wiki/Overview-on-Submitting-Features)
5+
- [ ] PR name matches the format *[ feature ]: <i>Feature Name</i> (<i>versions separated by comma</i>)*. More details [here](https://github.com/TheCodeRaccoons/WebTricks/wiki/Overview-on-Submitting-Features)
66
- [ ] PR's base is the `develop` branch.
7-
- [ ] Your Feature matches the standards laid out [here](https://github.com/TheCodeRaccoons/WebflowTrickery/wiki/Programming-Standards)
7+
- [ ] Your Feature matches the standards laid out [here](https://github.com/TheCodeRaccoons/WebTricks/wiki/Programming-Standards)
88

9-
<!-- Refer to the [contributing](https://github.com/TheCodeRaccoons/WebflowTrickery/wiki/Contributing) guidelines for more details. -->
9+
<!-- Refer to the [contributing](https://github.com/TheCodeRaccoons/WebTricks/wiki/Contributing) guidelines for more details. -->
1010

1111
## Features
1212
<!-- List your features here and the benefits they bring. Include images/codes if appropriate -->

CONTRIBUTING.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
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

Comments
 (0)