Re: [Inkscape-devel] new tutorial
Hi,
With that in mind, I decided to document this component painstakingly and uncompromisingly. The new "Shapes" tutorial ...
Very nice job.
Taking a closer look I (think I) found a few small textual problems:
"All four corner"
"Scale rounded corners" - "scale rounded corners" (both forms are used)
"then within its resize" (with?)
"or even to move" ("to" should probably be removed)
"Several rectangles..." (the layout of this text is strange: certain lines are too short)
"a integer-ratio"
"star tool" - "Star tool" (both forms are used)
"Once drawn, a star has two handles" (spiral?)
__________________________________ Do you Yahoo!? Take Yahoo! Mail with you! Get it on your mobile phone. http://mobile.yahoo.com/maildemo
Arpad Biro <biro_arpad@...36...> writes:
With that in mind, I decided to document this component painstakingly and uncompromisingly. The new "Shapes" tutorial ...
Very nice job.
I absolutely agree. In order to make it perfect even on the microtypography level, the hyphen in at least the "Conclusion" section should not be a "minus" but U+2013 (EN DASH).
Same for quotation marks: use U+201C and U+201D.
On a similar note, things like "i.e." should probably be written with a half space in between, but I'm not sure how well fonts support that, and gucharmap doesn't make it easy to check out.
Nitpickery yours, Colin
Colin Marquardt wrote:
I absolutely agree. In order to make it perfect even on the microtypography level, the hyphen in at least the "Conclusion" section should not be a "minus" but U+2013 (EN DASH).
Same for quotation marks: use U+201C and U+201D.
Eeeeeeeeek!!!!
Windows-1252 characters invade!!! EEEEk!
:-)
But just a minor point that those do take it out of Latin1 aka ISO-8859-1. Could be why those were not used to begin with.
(Oh and just to keep others informed, the unicode name for "-" is "hyphen-minus", with "hyphen" living at U+2010, and "minus sign" living at U+2212)
Date: Sat, 23 Oct 2004 00:50:40 +0200 From: Colin Marquardt <colin@...384...> To: inkscape-devel@lists.sourceforge.net Subject: [Inkscape-devel] Re: new tutorial
Arpad Biro <biro_arpad@...36...> writes:
With that in mind, I decided to document this component painstakingly and uncompromisingly. The new "Shapes" tutorial ...
Very nice job.
I absolutely agree. In order to make it perfect even on the microtypography level, the hyphen in at least the "Conclusion" section should not be a "minus" but U+2013 (EN DASH).
Same for quotation marks: use U+201C and U+201D.
good idea but isn't there a special character at the XML level like ‐ or suchlike for that? (not having looked at the sentence in question I'll bet it would be easier to rephrase, use bullet points or use a colon: than it would be to lookup the right codes).
On a similar note, things like "i.e." should probably be written
Abbreviations and Latin terms should be avoided entirely when writing documentation. Instead of i.e. one should simply write 'that is' or rephrase the sentence (and similarly instead of e.g. one should write for exmaple). Abbreviations are like bad compression and put an extra processing burden on the user when the work and effort to make things clearer should be done once by the author.
with a half space in between, but I'm not sure how well fonts support that, and gucharmap doesn't make it easy to check out.
Nitpickery yours,
We only nitpick because we are really glad that anyone would go to the trouble and effort of writing documentation. Think of it as our way of saying thanks.
- Alan
Alan Horkan wrote:
good idea but isn't there a special character at the XML level like ‐ or suchlike for that?
No.
Although specific applications/flavors of XML can define such named entities, none are defined by default other than & < > ' and ". On the other hand, the Unicode values are well defined, and all XML processors are required to handlt UTF-8 and UTF-16.
(not having looked at the sentence in question I'll bet it would be easier to rephrase, use bullet points or use a colon: than it would be to lookup the right codes).
Well, with bullet points you hit the same problem. The standard bullet character is not in the ASCII nor in the Latin-1 range. So again you'd need to go out to Unicode and the value U+2022.
participants (5)
-
Alan Horkan -
Arpad Biro -
bulia byak -
Colin Marquardt -
Jon A. Cruz