Mailinglist Archive: opensuse-doc (21 mails)

< Previous Next >
Re: [opensuse-doc] Re: [opensuse-marketing] The openSUSE Handbook proposal
  • From: Karl Eichwalder <ke@xxxxxxx>
  • Date: Wed, 06 Oct 2010 09:39:29 +0200
  • Message-id: <shzkurpy6m.fsf@xxxxxxxxxxxxxxx>
Hi Christian,

most of your arguments are not invalid ;) Nevertheless are we
discussing writing manuals (books with more than some 100 pages) or just
a bunch of Web pages (in older times: SDB articles)? Both have their
merits.

If it is about writing books, I do not buy your arguing about just
fixing a typo after pressing the "Edit" button, because up til now most
PDFs lack such a feedback button (would be a nice feature, though).

Even today, you can read the PDF with okular and make annotations that
you are free to submit as improvement feedback to the doc writers. If
you want to contribute, there is no need to learn XML. OTOH, learning
XML would not hurt ;)

XML usually is easy. A paragraph is just surrounded by a <para> element
and it does not matter whether you append an empty line or not. Ever
tried to edit an average wiki table? Wiki table are just the rebirth of
SGML (shortref and usemap features in combination with omittag: see
http://books.google.de/books?id=OyJHFJsnh10C&pg=PA62&lpg=PA62&dq=sgml+shortref&source=bl&ots=DFr_Adu5eE&sig=DtHug1N95vmPDIodnZ0ZFyt5cVM&hl=en&ei=iyWsTMqAM5ac4AbY0ISWCA&sa=X&oi=book_result&ct=result&resnum=10&ved=0CDkQ6AEwCQ#v=onepage&q=sgml%20shortref&f=false
--if the link is too long, just click this one:

http://books.google.de/books?id=OyJHFJsnh10C&pg=PA62 ).

Conclusion: Writing books is as it ever was--if you learned your lesson,
it is easy, if you did not, either the reader will have a hard time or
you will need a good editor...

--
Karl Eichwalder
R&D / Documentation

SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nuernberg)
--
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >