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

Guide: simplify testing section and move to end #17981

Closed
jkleint opened this issue Oct 12, 2014 · 1 comment
Closed

Guide: simplify testing section and move to end #17981

jkleint opened this issue Oct 12, 2014 · 1 comment

Comments

@jkleint
Copy link

jkleint commented Oct 12, 2014

Reading the Testing section of the Guide, it's a bit long and involved. Partly because it introduces attributes, and partly because it's mostly error messages. It interrupts the pace and flow of the guide a bit with material that isn't really built upon later.

Perhaps we could trim it down to the basics of "Here's what a test looks like; here's where they go; here's how to run them?"

Testing is important certainly, but it is mostly conventions and tooling around the language, rather than a core language concept. For this reason, and because it isn't needed for later sections, could we profitably move it toward the end of the Guide, perhaps after section 24 or 25?

@steveklabnik, what say you?

@steveklabnik
Copy link
Member

Testing is a very important concept, and deserves the full place in the guide. I actually already moved it back, the first draft it was 100% TDD 😉

it is mostly conventions and tooling around the language, rather than a core language concept.

The guide covers everything, including conventions and tooling. It's not just for the core language itself.

lnicola pushed a commit to lnicola/rust that referenced this issue Aug 29, 2024
minor: Fix cwd used for proc macro expansion

Fixes rust-lang#17980.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants