Odp: Dokumentacja

[Rafał Kleger-Rudomin]

-- 
Rafał Kleger-Rudomin (klakier w pg.gda.pl) 

On Wed, 3 Nov 1999, Radosław Habelski wrote:

> 
> ----- Original Message -----
> From: Rafał Kleger-Rudomin <klakier w pg.gda.pl>
> To: <pld-list w pld.org.pl>
> Sent: Wednesday, November 03, 1999 5:13 PM
> Subject: Re: Dokumentacja
> 
> 
> >
> > On Tue, 2 Nov 1999, Radek wrote:
> >
> > > ....Używałem wielu dystrybucji i jedno mogę o nich powiedzieć :
> > > dokumentacja w nich to skandal.Często zdarza się , że dokumentacja jest
> > > po prostu nieaktualna np.strony man .
> >
> > Może i się zdarza ale na to akurat nie ma siły - nikt nie będzie
> > aktualizował manów czy info do iluśset pakietów. I tak dobrze że są ludzie
> > którym chce się poświęcać czas na tłumaczenia.
> 
> Nie miałem tu na  myśli tylko dokumentacji w języku polskim , np. w RedHat6
> podręcznik : man smbmount nie podaje prawidłowej składni komendy smbmount,
> w Mandrake-u 6.1 jest dokładnie to samo.Wydaje mi się , że skoro zmienia się
> składnia polecenia to wypadałoby to uwzględnić w "man" ,co prawda nowa
> składnia
> jest podana , ale trzeba troche poszperać ...
> i nie jest to jedyny przyklad.
Wydaje mi się że jedna rzecz wymaga wyjaśnienia: many nie są (zazwyczaj)
pisane przez twórców dystrybucji, tylko przez twórców oprogramowania 
(samby). Nie możesz więc winić Redhata za nieaktualne many.
 
> > Jeśli masz czas i chęci zapraszam do tworzenia tejże.
> > Odpisz jeśli jesteś zainteresowany.
> >
> > Pozdrawiam
> > Rafał Kleger-Rudomin
> 
> Jak najbardziej , jestem zainteresowany .
> Prosiłbym o przesłanie informacji o aktualnym stanie tych prac kto to
> koordynuje
>  przyjętym formacie itd.

Fajnie.
Stan prac jest praktycznie zerowy :) - dopiero zaczynamy. Jak pewnie
zauważyłeś na razie trwały dyskusje na temat formatu, narzędzi itp.

Ogólnie zostało ustalone, że piszemy w formacie SGML-DocBook-DTD.

Co do docbooka, ta książka powinna wystarczyć na początek:
http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html

W cvs jest moduł docdevel - napisałem tam jak dotąd trochę o wykorzystaniu
xemacsa do pisania (przyjrzyj się też samemu modułowi)

Na razie tyle
Zastanów się czym byś chciał się zająć na początek (co Tobie się
wydaje najbardziej potrzebne do {o|na}pisania)

Pozdrawiam
Rafał Kleger-Rudomin
 
> po raz drugi na liście :
>                      Radosław Habelski
>                      rad w zak13.p.lodz.pl
> 
> 
>