On Wed, 2013-02-06 at 01:36 +0100, Uwe Stöhr wrote: > Am 06.02.2013 00:13, schrieb Uwe Stöhr: > I did this now the the Intro manual. I noted that you changed a lot if tiny > things, like putting > dots into quotations. Is this really necessary? I mean this doesn't improve > the documentation > because such changes do not contain information or clarify things.
I was approaching this from my experience of copy-editing where the principle is that nothing should get in the way of the reader. So I changed the little things to stop them being a distraction to a reader. > For the Intro manual it is in my opinion important to keep it simple. So > changes from "-" to "---" > are technically correct but confusing for newbies. If you insists of having > the correct character > here, we can use the long dash character directly instead of "---". I understand this from your earlier email - however, I made these suggestions before I received your earlier email. > > Annotations: > - why have you changed the image size of the buttons? The appear now so small > that one cannot read > their label. I therefore reset this change. I didn't realise I had done this. > - you added a footnote how to pronounce "TeX". I don't think that this > important to know for a > newbie. I therefore did not accept it. Fine. > - you changed the layout of the table. I understand that the table formatting > was not optimal, but > was once chosen because this is what you get when inserting a table from the > toolbar. However, we > can change it, but it looks in my eyes ugy with non-centered alignment and > without any lines. As > compromise I used the old layout but changed the border style to formal. > Fair enough. I thought the old layout of having the unit names centred was distracting. John
