dokumentacja

[Rafał Kleger-Rudomin]

Marcin Bohosiewicz <marcus w kernel.pl> writes:

> On 10 Jun 2002, Rafał Kleger-Rudomin wrote:
> > sugeruję, przyłącz do pisania PLD-Guide, pomóż rozwijać skrypty do 
> > renderowania strony żeby było ładniej, funkcjonalniej itd.
>
> Mozesz nie werbowac na PLD ludzi do innych projektow (tu: LDP) ? OK?

Tu udam że nie słyszałem, ok?

> > Rozumiem że masz dużo zapału. To super. Ale szkoda ten zapał marnować
> > robiąc po raz kolejny coś co już ktoś robił albo powielając stare błędy.
> Nie, zapal jest i cos do zrobienia (dokumentacja PLD) tez.
> I jak to bylo mowione na zlocie - liczy sie *tresc* a nie forma.

No i o to właśnie proszę: żeby się dołożyć do tworzenia treści
a nie rzeźbić jakieś cuda w php/sql/niewiadomoczym
 
> Przypominam tu sprawe opisu kernela, ktory zrobil dzimi - "pewna"
> grupa zamiast to poprzec i dyskutowac o tresci zaczela dzimiego potepiac
> ze pisze w "nieslusznym" formacie...

Nie żadna grupa, tylko ja go "potępiłem", rzeczywiście niesłusznie, 
za co go przeprosiłem. Zresztą w całej sprawie nie chodziło
o niesłuszny format tylko o brak koordynacji z resztą zespołu
i mnożenie kolejnych bytów. Dokładnie o to o co teraz chodzi.

> > Natomiast PLD-Guide już istnieje, działa i potrzeba mu tylko rąk do pracy.
> Ale nie jest czescia PLD. Kropka.

A co jest częścią PLD? To co kloczek uzna?
Jeśli już tak bardzo boicie się serka, to co za problem wziąć
PLD-Guide, wyciąć serkową część i napisać na nowo (nie mam nic 
przeciwko żebyś się tym zajął), przenieść PLD-Guide z powrotem do
cvs.pld i kropka. Ale po co do cholery wymyślać jakieś cuda wianki
na nowo?

Czytałem kloczka koncepcję z interfejsem www. To jest po prostu 
beznadzieja! Pisanie doców w przeglądarce???
Kloczek wyobraza sobie ze jak bedzie klikalny interfejs www to
zaraz wiara ruszy klikać dokumentację, bo wcześniej to nie umieli 
z cvsa i edytora korzystać. A figa. Również uważam że brak narzędzi
jest przeszkodą dla dokumentacji. Ale nie takich narzędzi trzeba.

Jeśli już, proszę bardzo: zrobić interfejs do updatów
wersji językowych PLD-Guide oparty o zmiany w drzewku xml
pozwalający w sposób automatyczny rozpoznawać że dodano/zmieniono
element w drzewku jednego dokumentu. Wystarczy na razie coś co będzie 
mogło tylko kontrolować aktualność poszczególnych wersji.

> > Rafał
> > p.s. No chyba że cała ta akcja jest inspirowaną przez Kloczka
> > inicjatywą mającą pogrzebać PLD-Guide w imię politycznych rozgrywek.
> Nie politycznych, a formalnych.
> I patrzac na to co ostatnio Cezar na LN wyslal (aspekty prawne OS) wyglada 
> na to ze z rzecami nie nalezacymi do projektu tzreba bardzo uwazac...

Nadal nie wiem kto decyduje co należy do projektu i na jakich zasadach.
Niemniej jest to dla mnie sprawa drugorzędna. Dla mnie istotne jest
by nie tworzyć bez sensu nowych bytów.

Pozdrawiam,
Rafał

-- 
Rafał Kleger-Rudomin (klakier w pld.org.pl)