ayo/mcfly
ayo/mcfly
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

chore: update contributing guide

Browse source
This commit is contained in:
Ayo Ayco 2025-02-10 23:18:41 +01:00
parent b103679154
commit 69016a5707
1 changed files with 16 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
CONTRIBUTING.md
View file

@ -1,8 +1,8 @@
# CONTRIBUTING to McFly # Contributing to McFly
Hi, and thanks for your interest to contribute to **McFly**! 🎉 Hi, and thanks for your interest to contribute to **McFly**! 🎉
This is the best place to start if you want to contribute to the project. You can do so by any of the following: This guide is the best place to start if you want to contribute to the project. You can do so by any of the following:
1. [Report issues or request features](#report-issues-or-request-features) 1. [Report issues or request features](#report-issues-or-request-features)
1. [Participate in discussions](#participate-in-discussions) 1. [Participate in discussions](#participate-in-discussions)
1. [Contribute code](#contribute-code) 1. [Contribute code](#contribute-code)
@ -10,11 +10,11 @@ This is the best place to start if you want to contribute to the project. You ca
## Report issues or request features ## Report issues or request features
To open issues or feature requests, see our [issue tracker](https://todo.sr.ht/~ayoayco/mcfly). You can also send them via email to [`~ayoayco/mcfly@todo.sr.ht`](mailto:~ayoayco/mcfly@todo.sr.ht). To open issues or request features, see our [issue tracker](https://todo.sr.ht/~ayoayco/mcfly). You can also send them via email to [`~ayoayco/mcfly@todo.sr.ht`](mailto:~ayoayco/mcfly@todo.sr.ht).
## Participate in discussions ## Participate in discussions
To open new or participate on existing discussions, see our [mcfly-discussions](https://lists.sr.ht/~ayoayco/mcfly-discussions) mailing list. To start or participate on discussions, see our [mcfly-discussions](https://lists.sr.ht/~ayoayco/mcfly-discussions) mailing list.
## Contribute Code ## Contribute Code
@ -25,33 +25,36 @@ To get started, setup [git send-email](https://git-send-email.io).
After setting up `git send-email` you can now follow the steps below to start hacking: After setting up `git send-email` you can now follow the steps below to start hacking:
1️⃣ Clone the repository to your local machine, then go into the project directory: 1️⃣ Clone the repository to your local machine, then go into the project directory:
```bash ```bash
$ git clone https://git.sr.ht/~ayoayco/mcfly $ git clone https://git.sr.ht/~ayoayco/mcfly
$ cd mcfly $ cd mcfly
``` ```
2️⃣ Create a new branch for your changes: 2️⃣ Create a new branch for your changes:
```bash ```bash
git checkout -b my-branch $ git checkout -b my-branch
``` ```
3️⃣ Make your changes, and then commit them with a descriptive message using [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/): 3️⃣ Make your changes, and then commit them with a descriptive message using [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/):
```bash ```bash
git commit -m "feat(core): implement server-side rendering" $ git commit -m "feat(core): implement server-side rendering"
``` ```
4️⃣ Use `git send-email` to send a patch: 4️⃣ Use `git send-email` to send a patch:
```bash ```bash
git send-email --to="~ayoayco/mcfly-patches@lists.sr.ht" HEAD^ $ git send-email --to="~ayoayco/mcfly-patches@lists.sr.ht" HEAD^
``` ```
> The `HEAD^` bit is a reference to the latest commit, which will be added to your patch. This could be a range of commits as well if you have mutiple commits. ### Tips:
5️⃣ Wait for a response from us whether the patch needs rework... or a notification if it gets merged! 💡 You can set the default "to" address for the project:
```bash
$ git config sendemail.to "~ayoayco/mcfly-patches@lists.sr.ht"
```
💡 The `HEAD^` bit is a reference to the latest commit, which will be added to your patch. This could be a range of commits as well if you have mutiple commits.
5️⃣ After successfully sending your patch, wait for a response from us whether the patch needs rework... or a notification if it gets merged!
> As a summary, we use `git` and `email` to collaborate on McFly. You have to set up [git send-email](https://git-send-email.io) and send patches via email. :) > As a summary, we use `git` and `email` to collaborate on McFly. You have to set up [git send-email](https://git-send-email.io) and send patches via email. :)