forked from Hashnode/starter-kit
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request Hashnode#71 from Haimantika/main
Added Conributing Guide
- Loading branch information
Showing
1 changed file
with
79 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,79 @@ | ||
# Contributing | ||
|
||
We would ❤️ you to contribute to Headless Hashnode Starter kit and help make it better! We want contributing to Hashnode to be fun, enjoyable, and educational for anyone and everyone. All contributions are welcome, including issues, integrations, updates and tweaks. | ||
|
||
## How to Start? | ||
|
||
If you are worried or don’t know where to start, you can checkout open issues or add new issues and comment your interest and a maintainer can guide you. Alternatively, you can send your questions to anyone from the [Hashnode team on Discord](https://hshno.de/discord). | ||
|
||
## Submit a Pull Request 🚀 | ||
|
||
Branch naming convention is as following | ||
|
||
`TYPE-DESCRIPTION` | ||
|
||
example: | ||
|
||
``` | ||
feat-adds-profile-section | ||
``` | ||
|
||
When `TYPE` can be: | ||
|
||
- **feat** - a new feature | ||
- **fix** - a bug fix | ||
- **refactor** - code change that neither fixes a bug nor adds a feature | ||
|
||
**All PRs must include a commit message with the description of the changes made!** | ||
|
||
For the initial start, fork the project and use git clone command to download the repository to your computer. A standard procedure for working on an issue would be to: | ||
|
||
1. `git pull`, before creating a new branch, pull the changes from upstream. Your main branch needs to be up to date. | ||
|
||
``` | ||
$ git pull | ||
``` | ||
|
||
2. Create a new branch from `main` like: `feat-adds-profile-section`.<br/> | ||
|
||
``` | ||
$ git checkout -b [name_of_your_new_branch] | ||
``` | ||
|
||
3. Work - commit - repeat (make sure you're on the correct branch!) | ||
|
||
4. Push changes to GitHub. | ||
|
||
``` | ||
$ git push origin [name_of_your_new_branch] | ||
``` | ||
|
||
5. Submit your changes for review | ||
If you go to your repository on GitHub, you'll see a `Compare & pull request` button. Click on that button. | ||
6. Start a Pull Request | ||
Now submit the pull request and click on `Create pull request`. | ||
7. Get a code review approval/reject. | ||
8. After approval, merge your PR. | ||
9. GitHub will automatically delete the branch after the merge is done. (they can still be restored). | ||
|
||
## Setup From Source | ||
|
||
To set up a working **development environment**, just fork the project git repository and install the necessary packages with the `pnpm install` command. | ||
|
||
> If you just want to get started with Headless Hashnode for day-to-day use and not as a contributor, you can refer to the [guide](https://hashnode.com/headless) or the [README](README.md) file. | ||
```bash | ||
git clone [email protected]:[YOUR_FORK_HERE]/starter-kit.git | ||
|
||
cd starter-kit | ||
|
||
pnpm install | ||
|
||
pnpm run dev | ||
``` | ||
<em> Note- Make sure to run `pnpm run dev` in the correct folder. You can find more instructions about it in the [README]( https://github.com/Hashnode/starter-kit/?tab=readme-ov-file#running-locally)</em> | ||
|
||
## Resources | ||
To stay updated with latest updates of Hashnode, you can follow: | ||
- [Changelog](https://hashnode.com/changelog) | ||
- [Hashnode Discord Server](https://hshno.de/discord) |