Mailinglist Archive: opensuse-doc (14 mails)

< Previous Next >
Re: [opensuse-doc] The openSUSE distribution chages are way ahead of documentation?
  • From: Rajko M <rmatov101@xxxxxxxxxxx>
  • Date: Sat, 30 Sep 2006 17:50:33 -0500
  • Message-id: <451EF4B9.7070606@xxxxxxxxxxx>
Andreas Jaeger wrote:
> Just a short remark to this thread:
> Novell has a documentation team working on our manuals, nothing has
> changed here (see It's
> not developers writing manuals, it's dedicated editors - some of them
> coming from development and others from other areas.
> Since we have a holiday on tuesday, most of us take a long weekend
> (monday of as well), so don't expect direct feedback on this by the
> documentation team.
> Somebody mentioned that software is only finished at the end - this is
> not completely true since openSUSE. My goal is to get features in
> early so that they can be tested and documented early. It's still
> very tight for the documentation team but it was even worse before;-(.
> Cheers,
> Andreas

Thanks for the response Andreas.

I know that developers don't write documentation, at Novell, but in the
most of small projects they do, and that is where serious improvement is
needed. Novell/SUSE guys are trying hard to bring people in, but still,
one needs too much to learn before can start contributing.

One preconfigured package/pattern that contains all available software
for documentation writing, for instance SVN with links to Novell
repositories, editor with Novell like templates, and probably much more,
will make volunteers life easier and move focus from tools to content.

I hope that documentation guys will have some answers, instructions,
ideas, as we need some in order to get involved.

My idea of ideal world of documentation writer is one browser where one
can read existing manuals, howto's etc, than when something was found
start editor and change document. When done, submit for approval,
proofreading and that's it. After some time get feedback, if it is
accepted or not, or in need of further changes additions.

In this world somebody else will think how to structure whole
documentation, where to move balance, how to name articles.

To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >
List Navigation