Mailinglist Archive: opensuse-doc (40 mails)

< Previous Next >
Re: [opensuse-doc] The openSUSE distribution chages are way ahead of documentation?
  • From: Rajko M <rmatov101@xxxxxxxxxxx>
  • Date: Tue, 3 Oct 2006 22:37:19 -0500
  • Message-id: <200610032237.19733.rmatov101@xxxxxxxxxxx>
On Tuesday 03 October 2006 20:22, linux_learner wrote:
> The problem is, we have more developers than documenters. Even the
> documentation of smart on opensuse.org is quite pathetic. I wrote the
> smart howto here
> http://wiki.suselinuxsupport.de/wikka.php?wakka=HowtoSmartPackageManager
> I just don't know how to import it into opensuse.org

It shouldn't be a problem.
The opensuse version was just a stub (name for incomplete article), that
should be compelling for someone to write more. As I can see you already
started. I formated it and edited a bit.

> The documentation on rug just plain sucks. I started to document it,
> but then the guy hosting my site went down, and I lost the wiki
> database. I was about half way done with the rug portion of it.

It happens.
Keep your page sources locally, just in case.

> YaST, as y'all have discussed, is severly under documented.

That is to the some extent right. Please look at the collection on:
http://en.opensuse.org/YaST_Documentation_Portal

This is rough digest of all articles listed with search for yast, rug, zmd,
and libzypp. I know it could be better, but right now I'm trying to index all
pages in a few categories and call for help to move things around until
(almost) everybody is satisfied.

Why not mediawiki built in categories?
It is much faster to make index than to walk from page to page and add
[[Category:<some_category>]] and for some articles multiple times.

> I am more of a package manager specialist. I could volunteer to
> document package management (apt, yum, rug, zmd, smart. etc..)
.....

That is how it works, everybody writes what likes the most.
It doesn't hurt if one is expert for the field and good writer, but such
combinations are seldom, and we have to rely on a team work. One writes, and
later others add paragraphs, links, templates and images, clean errors in
spelling and style, rewrite to make it more readable, give comments and ask
questions on corresponding discussion pages.

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

< Previous Next >
List Navigation
This Thread
References