marvin-zhao / svnbook

Automatically exported from code.google.com/p/svnbook
0 stars 0 forks source link

Use proper quote signs and apostrophes #12

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago
Use “ and ” in the text where appropriate, and ‘ and ’ also.  Unicode 
also
defines ’ for an apostrophe.

Original issue reported on code.google.com by hamar...@gmail.com on 1 Dec 2008 at 10:43

GoogleCodeExporter commented 9 years ago

Original comment by cmpilato on 17 Dec 2008 at 5:17

GoogleCodeExporter commented 9 years ago
Eye-candy, that adding no value to the text.
Moreover, it could confuse readers if accidentally used in "less appropriate" 
places.
It's good et. all in literary texts, but better avoid such practice in 
documentation.
IMO.

Original comment by anrdae...@freemail.ru on 21 Mar 2009 at 2:55

GoogleCodeExporter commented 9 years ago
On the contrary, I believe clearly defined "start" and "end" delimiters do add 
value
(if only a small bit) to the text.  Imagine editing HTML where the tag 
delimiters
were not < and >, but just a single character whose "start" and "end" you had to
track contextually:

  |html||head||title|My title|/title||/head|
  |body||p|1 lily is too little, but
  |span style="font-style: italic;"|3|/span| lilies
  is too much.|/p||/body||/html|

Of course, you have to be careful to only use it in the prose of the book, not 
in
command-line examples where perhaps the ASCII double-quote is required for 
proper
operation.  And realistically speaking, we aren't likely (note the "unlikely"
Milestone) to make this kind of a sweeping change.

Original comment by cmpilato on 23 Mar 2009 at 1:48

GoogleCodeExporter commented 9 years ago

Original comment by cmpilato on 28 Jun 2011 at 7:14

GoogleCodeExporter commented 9 years ago

Original comment by cmpilato on 18 Jan 2013 at 9:39