Skip to content

Commit

Permalink
πŸ”€ Add a contribution guide (#14)
Browse files Browse the repository at this point in the history
* πŸ“ Add a contribution guide
  • Loading branch information
DRFR0ST authored Sep 21, 2024
1 parent 3793f82 commit d2006b1
Show file tree
Hide file tree
Showing 2 changed files with 84 additions and 2 deletions.
62 changes: 62 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Contributing to bun-bagel πŸ₯―

πŸ‘‹ Thanks for considering contributing to bun-bagel! Your help in enhancing this library is greatly appreciated.

## Getting Started πŸš€

1. **Fork the repository:** Click the "Fork" button 🍴 at the top right of the repository page. This creates your own copy of the repository.
2. **Clone your fork:** `git clone https://github.com/<your-username>/bun-bagel.git`
3. **Create a branch:** `git checkout -b feature/your-feature-name` or `git checkout -b bugfix/your-bugfix-name` 🌿
4. **Install dependencies:** `bun install`
6. **Make your changes:** Implement your feature or fix the bug πŸ› οΈ
5. **Run tests:** `bun test`
7. **Commit your changes:** `git commit -m ":<gitmoji>: <your commit message>"` πŸ“
8. **Push to your fork:** `git push origin feature/your-feature-name` or `git push origin bugfix/your-bugfix-name` πŸš€
9. **Create a pull request:** Go to the original repository and click the "New pull request" button. Select your fork and branch, then provide a clear description of your changes. πŸŽ‰

## Coding Style 🎨

**Coming soon!**

## Code Review πŸ”

* We use GitHub's pull request system for code review.
* Please be patient and respectful during the review process.
* We'll try our best to provide constructive feedback and help you improve your code.
* We'll also be happy to answer any questions you have about the codebase.
* We'll merge your pull request once it's been reviewed and approved.


## Commit Messages πŸ“

We use emoji's based on Gitmoji guidelines to enhance the expressiveness of our commit messages, making them more informative and easier for contributors to understand.
We use the following format for commit messages:

```
:<gitmoji>: This commit will... <your commit message>
```

**Examples:**

* `:bug: Fix a bug that caused the app to crash`
* `:sparkles: Add a super cool animation for the button component`
* `:recycle: Refactor footer component`
* `:fire: Remove deprecated code`
* `:package: Install bun-bagel@latest`

You can find a list of available gitmojis on [gitmoji.dev](https://gitmoji.dev/).
It might be difficult at times to pick the right emoji, but please don't stress, follow your gut feeling.

> [!NOTE]
> Notice that the commit message usually completes the sentence "This commit will...".
## Reporting Issues πŸ›

If you find a bug or have a feature request, please open an issue on the [issue tracker](https://github.com/DRFR0ST/bun-bagel/issues).

## Additional Notes πŸ“Œ

* Please ensure your code passes all tests before submitting a pull request. βœ…
* If you're unsure about anything, feel free to ask questions in your pull request or open an issue. ❓

Let's build something great together! πŸ₯―
24 changes: 22 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,8 +119,28 @@ console.log(response.status); // => 404
console.log(response.headers); // => { "x-foo-bar": "baz" }
```

## 🀝 Contributing

Contributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for details.

## πŸ”¨ Development

To contribute to bun-bagel, follow these steps:

1. Clone the repository: `git clone https://github.com/DRFR0ST/bun-bagel.git`
2. Install dependencies: `bun install`
3. Run tests: `bun test`
4. Build the library: `bun run build`

> [!NOTE]
>You can also play around with bun-bagel by making changes in the `/sandbox` directory and running `bun run sandbox`. Make sure to build the library after making changes in the `/src` directory.
## 🀝 Community

Join the discussion on the [GitHub Discussions](https://github.com/DRFR0ST/bun-bagel/discussions) page.

## πŸ“ License
This project is licensed under the terms of the MIT license. See the LICENSE file for details.
This project is licensed under the terms of the MIT license. See the [LICENSE](https://github.com/DRFR0ST/bun-bagel/blob/main/LICENSE) file for details.

#### πŸ“’ Thanks to all contributors for making this library better!
#### πŸ€– Thanks to Gemini for generating most of this code and readme.
#### πŸ€– Thanks to Gemini for generating a part of the initial code and readme, and helped brainstorm the idea.

0 comments on commit d2006b1

Please sign in to comment.