Rajko M a écrit :
The YaST and a company, is resting primarily with Novell/SUSE doc team.
but is still poorly documented, as SuSE folks focused on the
administrator guide on general Linux infos (making probably
the better book ever on the subject)
process is still missing clear structure. Where to pick up source, (...)
this is not structure in the way I mean it. This is tools.
Of course it's very usefull, certainly necessary, but the
structure I speak of is the organisation of the
documentation itself. what chapters, what titles, what page
names (for the wiki), what categories...
we all worked on that one day or an other, but the result is
still very unperfect, I know of pages I can't find again
(even page I did write myself :-()
Part of the solution is probably to work on the wiki (as a
base tool) like if it was a book. that is no search engine,
no google, but as many Table of Content/index as we want.
once this structure well formed (and the "portal" sub
structure is a good example), it should be looked for
portals administrators.
The only way to have a page up to date is to have one author
responsible of that. This don't mean this page (portal)
admin have to write all himself, on the contrary he should
have only to manage the pages (as in "manage a team")
Think of docbook "chapters", "articles", "titles". any body
can write articles in a semi informal manner, given somebody
gives the shape.
25 years ago, my wife wrote a "memoire" (wite paper) about
computer aided english teaching. At that time I had only
scholar english and she had a master :-), but I'm not too
bad as organisation. so I took it's work, asked her the good
questions and organised the document. It's a very
interesting experience to organise a document you nearly
don't understand
Our goal now is similar, but the document is much bigger,
the author nearly impossible to have at hand (and I have 25
years more :-(), so the task is very difficult.
but, in fact, we don't have to do this right now for an
exam. It will go it's pace, slowly, and we can hope the
result will be better and better when the time passes :-)
jdd
--
http://www.dodin.net
http://dodin.org/galerie_photo_web/expo/index.html
http://lucien.dodin.net
http://fr.susewiki.org/index.php?title=Gérer_ses_photos
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
