Mailinglist Archive: yast-devel (116 mails)

< Previous Next >
Re: [yast-devel] YaST Workshop 2008
  • From: Lukas Ocilka <lukas.ocilka@xxxxxxx>
  • Date: Mon, 23 Jun 2008 10:47:14 +0200
  • Message-id: <485F6312.3080004@xxxxxxx>
Stefan Hundhammer wrote:
On Friday 20 June 2008 17:26, Martin Vidner wrote:
My pet issue with the documentation is its structuring. With a
proper one, one could neatly divide it into packages, have pieces of
it drop in...
Here is a prototype:
http://www.suse.de/~mvidner/refdoc-prototype/

I agree.

The monster document known as "The Definite Guide" is useful if you want to read all documentation, or if you want to get an overview what documentation is available at all. But it's pure hell to search for anything, in particular if you have a rough idea where it is. I have a hard time finding my own UI reference documentation there...

I personally use only these pieces:

* YCP Modules
* SCR Agents
* Reference — YCP Language
* Reference — User Interface

I'd easily drop all those monster documents. We should think about what developers want and need.

If you can't find your documentation, try one-file-documentation, there you can see what is the documentation all about:
http://forgeftp.novell.com/yast/doc/SL11.0/onefile/
(Well, 6 files, but you'll definitely find it).

Bye
Lukas

< Previous Next >
Follow Ups