dokumentacja

[Tomasz Kłoczko]

On Tue, 11 Jun 2002, wrobell wrote:

> On Tue, Jun 11, 2002 at 03:11:36PM +0200, Tomasz Kłoczko wrote:
> > On Tue, 11 Jun 2002, wrobell wrote:
> > [..]
> > > Dlatego każda osoba, która robi dokumentację, jest proszona o nauczenie się
> > > XML DocBook-a.
> > 
> > Nie chcę być upierdliwy ale powtórze że dla dokumentalisty stawianie tego 
> > wymogu jest zbędnym balastem.
> To tak jakbyś powiedział, że dla developera PLD, stawianie wymogu znania cvs-a
> jest zbędnym balastem.

Wszystko zależy od tego co wynika z tego co jest podstawowym zestawem 
wiedzy i narzędzi danego śrosdowiska. Zajmowania się czymś takim co my 
robimy wcale nei determinuje od tracu użycia cvs i bez tego radzi sobie 
wiele dystrybucji. Analgicznie jest w przyapdku dokumentacji.

Mówiąc inaczje pzrestań patrzeć na to od strony narżedzia a zacznik 
patrzeć od strony wypełniania konkretnych wymogów i zatanawiania się czy 
to co bierzesz na stół spełnia te wymogi.
Powtórze bo najwidoczniech chcesz się czepić mnie a ni tego o czym mówię: 
rozwiązanie jakie moze yć opartę o frontend na www i spzrerzenie z bazą 
danych i moze jeszcze czyms innym może nie jest najlepsze. Jzeli nie 
chcesz żebym zaczał ignorować Twoich uwwag to albo zacnij się zastanawiać 
nad *konktretną* kontrpropozycją (i nie mów że rozwiązanie oparte o xml 
jest juz gotowe do użycia bo też je trzba dopiero bedize zrobić) albo 
zacznij modyfikować słąbe punkty niowego rozwiązania.

Chcesz krytykować - nie ma sprawy ale zajmij się krytyką twórczo.

> > Powtrze takzę że sprzrzenie tego z bazą da możliwość przewchowywania
> > informacji o statusie prac w sposób jaki nie jest lub będzie duuzo cięższy 
> > i/lub dużo mniej przejrzysty niż w przypadku trzymanai tylko sgml.
> > Z huierarhicznego układu częąści skąłdowych dokumentu wygenerować xml a 
> > dalej cokolwiek innego jest niesamowicie prosto.
> 
> Jesteś w stanie stworzyć i _rozwijać_ taką bazę danych, która
> będzie miała możliwości DocBook-a?

Nie jstem w stanie bo zajmuję się zwykle czymś innym.
Chcę mieć środowisko w którym dodanie raz na kilka tygodni kawałeka tekstu 
czy poprawienie czegoś nei będzie wymahgało odemnie za dużo zachodu.

> Spójrz na:
> 
>     http://www.docbook.org/tdg/en/html/docbook.html
> 
> I zastanów się ile to jest pracy.

Sporo biorąc pod uwagę objętość. Owa objętoś nie bierze się z powiretrza 
i zajrzyj sobie do repo na SF od kiedy owa dokumentacjapowstaje. Jak Po 
upływie podobnego czasue będziemy mieli wiecej to będzi możan powiedzieć 
że podwzgledem komplikacji warszatatu najprawdopodobniej udało nam się cos 
tu zrobić lepiej.
Użycie do tego celu xml jeszcze niczego nie gwarantuje. Po za tym
przypomnę że nie chodzi o konsrwację dukumentacji w jednym języku co
conajmniej w dwuch.

kloczek
-- 
-----------------------------------------------------------
*Ludzie nie mają problemów, tylko sobie sami je stwarzają*
-----------------------------------------------------------
Tomasz Kłoczko, sys adm @zie.pg.gda.pl|*e-mail: kloczek w rudy.mif.pg.gda.pl*