Skip to content

Conversation

@steveklabnik
Copy link
Contributor

Three more sections

@rust-highfive
Copy link
Contributor

r? @pcwalton

(rust_highfive has picked a reviewer for you, use r? to override)

Copy link
Contributor

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/

@steveklabnik
Copy link
Contributor Author

Thanks @apasel422 ! updated

Copy link
Member

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.

Copy link
Contributor Author

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 😄

Copy link
Member

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!

Copy link
Contributor Author

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.

Copy link
Contributor

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.

Copy link
Contributor

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.

Copy link
Contributor

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.

@alexcrichton
Copy link
Member

@bors: r+ 6476a1e rollup

Nice!

alexcrichton added a commit to alexcrichton/rust that referenced this pull request Apr 14, 2015
@bors bors merged commit 6476a1e into rust-lang:master Apr 15, 2015
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

Successfully merging this pull request may close these issues.

9 participants