Book: Make punctuation consistent before publishing

Created on 5 Jul 2016  Â·  5Comments  Â·  Source: rust-lang/book

Idk if this is something we should handle or something nostarch can take care of... but fancy double and single quotes are inconsistently used (i think you mentioned something stripped some of them out at some point, @steveklabnik ?) and because of that I haven't been bothering. Whatever we do shouldn't change quotes in code blocks, though.

I also have a bad habit of putting -- when I should be putting –, I'm sure there's going to be places I need to fix when we're done.

Bug Q for nostarch

Most helpful comment

I used to have a vim plugin that inserted them automatically, but then I got a new computer.

All 5 comments

I used to have a vim plugin that inserted them automatically, but then I got a new computer.

Hi! Is this something I could help out with?

Hi! Is this something I could help out with?

Possibly! The only thing is I'm not sure yet what NoStarch will want. Let me get back to you on that.

hey @terrynsun, are you still looking for something to work on? https://github.com/rust-lang/book/issues/123 is something else along these lines that we could use :)

Now that I've been through a round of formatting stuff with nostarch, I'm going to close this. They move our markdown into a word doc (and eventually a PDF), and that seems to be taking care of the fancy quotes. I'm finding myself caring less and less about which quote characters are used in the web version-- if anyone cares deeply, I would accept a PR that makes them all consistent one way or the other!

Also I've basically been trying to avoid using --.

Was this page helpful?
0 / 5 - 0 ratings