-
Notifications
You must be signed in to change notification settings - Fork 14k
Even moar editing #24273
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
Even moar editing #24273
Conversation
|
r? @pcwalton (rust_highfive has picked a reviewer for you, use r? to override) |
src/doc/trpl/functions.md
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/expression based/expression-based/
45fa450 to
2cc24a7
Compare
|
Thanks @apasel422 ! updated |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Out of curiosity, why the switch to a unicode apostrophe? I'm not sure that other contributors to the docs may follow that style if it's harder to type, but I dunno if it makes much of an inconsistency.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
it's technically more correct and a very commonly requested thing, I know @dherman really wanted it 😄
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I guess I'm just worried that we'll have to continually make passes through the documentation to update something like this, or I just don't know how to type it!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't plan on doing a mega-edit to update them, it's only because I'm already doing a readthrough of all this that I'm fixing it.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would suggest using smartypants, which was designed to do this sort of thing, rather than using untypeable(?) characters in the markdown, especially for common punctuation. The version of hoedown rustdoc uses supports it, so it'd be a matter of adding an extra pass to rustdoc for the book.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I really miss typographic quotes as well, but I think we ought to be consistent. We should run smartypants at build-time. Hoedown ships with a smartypants binary which we ought to add to the existing rust wrapper.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
maybe prefer ASCII is always nice.
2cc24a7 to
8b6987a
Compare
Three more sections
Three more sections