0
0
mirror of https://github.com/honojs/hono.git synced 2024-11-22 11:17:33 +01:00
hono/docs/CONTRIBUTING.md
MohammadHasan Akbari 4031fa8937
chore: add development environment (#2095)
* feat: add development environment

* refactor: update README

* refactor: update README and run yarn denoify

* refactor: update CONTRIBUTING
2024-01-28 22:32:51 +09:00

46 lines
1.7 KiB
Markdown

# Contribution Guide
Contributions Welcome! We will be glad for your help.
You can contribute in the following ways.
- Create an Issue - Propose a new feature. Report a bug.
- Pull Request - Fix a bug and typo. Refactor the code.
- Create third-party middleware - Instruct below.
- Share - Share your thoughts on the Blog, Twitter, and others.
- Make your application - Please try to use Hono.
Note:
This project is started by Yusuke Wada ([@yusukebe](https://github.com/yusukebe)) for the hobby proposal.
It was just for fun. For now, this stance has not been changed basically.
I want to write the code as I like.
So, if you propose great ideas, but I do not appropriate them, the idea may not be accepted.
Although, don't worry!
Hono is tested well, polished by the contributors, and used by many developers. And I'll try my best to make Hono cool, beautiful, and ultrafast.
## PRs
Please ensure your PR passes tests with `yarn test:all`. Also please ensure the Deno code is generated with `yarn denoify`.
## Third-party middleware
Third-party middleware is not in the core.
It is allowed to depend on other libraries or work only in specific environments, such as only Cloudflare Workers. For examples:
- GraphQL Server middleware
- Firebase Auth middleware
- Sentry middleware
You can make a third-party middleware by yourself.
It may be under the "honojs organization" and distributed in the `@honojs` namespace.
The monorepo "[honojs/middleware](https://github.com/honojs/middleware)" manages these middleware.
If you want to do it, create the issue about your middleware.
## Local Development
```
git clone git@github.com:honojs/hono.git && cd hono/.devcontainer && yarn install
docker compose up -d --build
docker compose exec hono bash
```