-
Notifications
You must be signed in to change notification settings - Fork 36.6k
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
contributing.md: Fix formatting (line lengths and smart quotes) #8226
Conversation
Is there any rendered difference? trivial ACK if it's felt this is worth merging, after it's squashed into a single commit. |
ACK after squash |
This commit contains two changes to CONTRIBUTING.md that: Fix line line lengths. There were several instances where line lengths were well over 80 characters. This commit adjusts them to make them conform to formatting best practices, to stay under 80 characters when possible. Adhere to consist use of quotes. There are a few instances where smart quotes are used (perhaps because it was pasted from a word processor). This commit replaces them with dumb quotes to keep it consistent with the quotation formatting found in the rest of the document.
@fanquake @MarcoFalke @paveljanik Thank you all for the review. Squashed the changes into one commit as per your suggestions. |
ACK be1d451 |
ACK be1d451, verified that the text does not change apart from smartquotes and whitespace. |
So "quoting" better than “quoting”? Isn't the latter usually preferable, unless when dealing with programming languages? I'm not convinced this is an improvement. |
@laanwj Hello, both are used in the document, so I chose the one that was more prevalent (dumb quotes) not only in the document, but in the codebase as well - I can switch all of them to one or the other, so they match in this file, however, my personal recommendation (for whatever it's worth 😀) would be to use dumb quotes, because it's easier to use on the command line, for example when grepping or just in general (much easier to use a regular dumb quotes key in the terminal as opposed to typing smart quotes in Emacs or Vim for example). If you have a preference please let me know, or if you'd rather the document be left as-is I can revert the change. Thank you sir, for the feedback and review! Also, thanks Mr. @sipa! |
…quotes) be1d451 contributing.md: Fix formatting (Will Binns)
… smart quotes) be1d451 contributing.md: Fix formatting (Will Binns)
… smart quotes) be1d451 contributing.md: Fix formatting (Will Binns)
… smart quotes) be1d451 contributing.md: Fix formatting (Will Binns)
This PR contains two commits onto
CONTRIBUTING.md
that: