Mailinglist Archive: opensuse-doc (50 mails)

< Previous Next >
Re: [opensuse-doc] Online Manual input source
  • From: "Hylton Conacher (ZR1HPC)" <hylton@xxxxxxxxxxxxxx>
  • Date: Tue, 08 May 2007 18:08:58 +0200
  • Message-id: <4640A09A.4050206@xxxxxxxxxxxxxx>
Rebecca Walter wrote:
> On Sunday 06 May 2007 20:58, Hylton Conacher (ZR1HPC) wrote:
>> As a subscriber to the opensuse-users list for a few years and seeing
>> the queries that are answeered there, may I suggest that the mailing
>> list posts become  a part of the online manual as it is here, in
>> opensuse-users that many problems are solved.
>>
>> I have often thought of using the opensuse list as a source to write my
>> own SUSE manual but have problems getting started, especially i.t.o. f
>> the structure/contents.
>>
>> I am unsure how to do it across distro versions but if someone at
>> OpenSUSE could have final say on wheher a wiki entry is published or
>> not, I am almost sure that this would be an excelent example of
>> opensource sharing.
>>
>> What are you folk' thoughts on this?
> 
> Have you looked into the Lessons for Lizards project?  It might be an 
> excellent way to get the information you consider important into an 
> easily-accessible format..... 
I have, and find that it is not categorised and as structured as I would
have expected and the menu is faar too long as I am almost sure many of
the subheadings could be grouped under a single parent heading.

> .... The plan is to provide LfL on an equal footing to 
> our internally-produced manuals, so it definitely would be somewhere even 
> newbies could find it.
With this in mind ie that newies and Windows users will be reading LFL,
it needs to be far more structured so that it is easy to navigate an
item a newbie is searching for assistance on.

> The in-house documentation team is willing to help you get started 
> contributing articles and help with conversion to docbook if needed.
I would be interested in joining the DUSE Documentation Team and lending
a hand, learning lots but producing a better customer experience. I
cannot say I know Linux, but I know more about Linux than the average
Windows user and I have a willingness to learn. I'm thinking of perhaps
writing a few pages on tips that I would be interested in ie I'd
establish the tip but ask that I can then pose questions on the opensuse
list and also to the documentation team to obtain the information I need
to complete the tip.

I notice that Openoffice.org 2.04 can save in Docbook format and I
wonder if the template is available in .odt format? I'd have a later
version of OOo but I haven't been able to get Yast to find a newer source.

> Unfortunately there isn't an effective wiki->docbook conversion tool at this 
> time.
That's fine, but then there needs to be a method to distribute all the
varied subjects that come in via email to the opensuse list to a LFL
writer. I propose someone who reads all the opensuse mail and forwards
the email to a ariety of LFL topic writers ie if I was the email
distributor and if you only dealt with the system updates section in the
LFL book then you would only receive email from me if something was
discussed on the opensuse list about updates. Emails about networking
would go to the LFL networking writer, but he would not know or receive
anything from me about updates as that is not the topic he/she are
concentrating on.
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >
Follow Ups