Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make Contributing guide more newbie friendly #5537

Conversation

matildasmeds
Copy link
Contributor

Motivation

One of the first things a new contributor will want to do, is to execute the tests for the project. We can make tokio more accessible to newbies, by making running tests as simple as possible.

Solution

This PR amends the existing Contributing guide, by adding links to fundamental testing concepts in Rust, and information about conditional compilation attributes and how to use them to run tests with cargo.

* Add links to fundamental testing concepts in Rust
* Add information about conditional compilation attributes
  and how to use them to run tests with cargo
@satakuma satakuma added the A-readme Area: Documentation that isn't part of any crate such as README.md or CONTRIBUTING.md label Mar 11, 2023
CONTRIBUTING.md Outdated Show resolved Hide resolved
Co-authored-by: Alice Ryhl <aliceryhl@google.com>
CONTRIBUTING.md Outdated Show resolved Hide resolved
Co-authored-by: Taiki Endo <te316e89@gmail.com>
Copy link
Member

@satakuma satakuma left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR. I left some minor comments inline. Could you please wrap all lines to 80 characters to match the formatting style used in this document? You can use reference-style links to deal with long URLs.

CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
matildasmeds and others added 5 commits March 12, 2023 18:53
Co-authored-by: Tymoteusz Wiśniewski <tymo@tymo.xyz>
Co-authored-by: Tymoteusz Wiśniewski <tymo@tymo.xyz>
@matildasmeds
Copy link
Contributor Author

Thanks for all the feedback and suggestions so far!
Fixed the width and links. 😄

Copy link
Member

@satakuma satakuma left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's fix the link and we should be good to go!

CONTRIBUTING.md Outdated Show resolved Hide resolved
Co-authored-by: Tymoteusz Wiśniewski <tymo@tymo.xyz>
@satakuma satakuma merged commit bfc4379 into tokio-rs:master Mar 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-readme Area: Documentation that isn't part of any crate such as README.md or CONTRIBUTING.md
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants