Skip to content

Commit 02b119b

Browse files
committed
docs(contrib): improve CONTRIBUTING with more ways to help
1 parent aa9aa0d commit 02b119b

File tree

1 file changed

+30
-2
lines changed

1 file changed

+30
-2
lines changed

CONTRIBUTING.md

+30-2
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,38 @@
11
# Contributing to Hyper
22

3-
You want to contribute? You're awesome! Don't know where to start? Check the [list of easy issues](https://github.com/hyperium/hyper/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy).
3+
You want to contribute? You're awesome!
4+
5+
Contributions come in all shapes and sizes. Let's take a tour of some of the different wants you could contribute.
6+
7+
## [Code of Conduct](./docs/CODE_OF_CONDUCT.md)
8+
9+
Firstly, all interactions with the project need to abide by the code of conduct. This is to make sure everyone is treated kindly.
10+
11+
## [Issues](./docs/ISSUES.md)
12+
13+
- **Filing an issue** is a contribution. We appreciate you letting us know about bugs you've found, and any information that you can provide that we can use to make hyper better. Without your filing it, we may not be aware of the bug.
14+
- [Triaging issues](./docs/ISSUES.md#triaging) is a huge help. By your helping make issues better, the reporters can get answers sooner, and others can fix them with less effort. You can also volunteer as a frequent [triager](./docs/MAINTAINERS.md#triagers).
15+
- Discuss [feature requests][feat] (especially those marked [request-for-comment][b-rfc]).
416

5-
[easy tag]: https://github.com/hyperium/hyper/issues?q=label%3AE-easy+is%3Aopen
617

718
## [Pull Requests](./docs/PULL_REQUESTS.md)
819

20+
By the way, consider checking the [list of easy issues](https://github.com/hyperium/hyper/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) if you want to submit something.
21+
922
- [Submitting a Pull Request](./docs/PULL_REQUESTS.md#submitting-a-pull-request)
1023
- [Commit Guidelines](./docs/COMMITS.md)
24+
25+
## Documentation
26+
27+
Improving hyper's documentation is a huge help for everyone who is trying to _use_ hyper.
28+
29+
- The API documentation (rendered at https://docs.rs/hyper) is stored as rustdoc comments directly in the source.
30+
- The main website has [tutorial-style guides](https://hyper.rs/guides). As of v1, they are currently in a [revamp](https://github.com/hyperium/hyper/issues/3411), and wouldly greatly benefit from being filled out.
31+
32+
## Help
33+
34+
Helping others use hyper in their specific workflows is a very valuable way to contribute.
35+
36+
- Answer questions asked directly in hyper's [Discussions](https://github.com/hyperium/hyper/discussions).
37+
- Join our [Discord](https://discord.gg/kkwpueZ) and help those who show up with questions.
38+
- **Blog about hyper.** You writing a blog post about how you use hyper to do something specific, or how you contributed a new feature, or debugged something in it, is a great idea. Not all examples can fit in the hyper repo. Search engines will help people find their use cases on your blog. And you can describe processes in more depth or from a different perspective.

0 commit comments

Comments
 (0)