🚀 go-pugleaf

Motto:
Documentation is like sex: When it is good, it is very, very, good.
And when it is bad, it is better than nothing.
                                                  /Dick Brandon/

On Sat, Mar 22, 2003 at 09:30:48AM +0100, Wojciech Myszka wrote:
> Ja pozwolę sobie na trzy grosze (z czego połowa nie na temat).
A ja myślałem, że półgroszaki już wyszły z użycia ;)

> 1. Znakomita robota dla zapaleńca, który chce się zorientować co
> pakiety mogą i pragnie mocno podszkolić się w angielskim.
Trochę nie ma sensu. I tak nie przetłumaczymy całej dostępnej
dokumentacji na polski, prędzej czy później ktoś będzie zmuszony
do korzystania z obcojęzycznej dokumentacji.

> 2. Tłumaczenie nie rozwiąże żadnego z problemów: zawsze się
> znajdzie iluś (nowicjuszy/wygodnickich/zmuszonych), którzy tu
> wadną z pytaniem [...nie chce mi się szukać...] na gwałt
> potrzebuję czegoś co mi zrobi coś!
Jest takie piękne zdanie, które obrazuje podejście do czytania
dokumentacji (podkreślenie moje): jeżeli _wszystko inne_ zawiedzie
przeczytaj manual.

A rzeczywistość wygląda na przykład tak. Mój kolega (nomen omen biolog)
za moim poduszczeniem postanowił napisać swoją magisterkę w LaTeXu.
Z różnych przyczyn nie chce szukać rozwiązań swoich problemów tutaj
i pytaniami męczy mnie. Moja wiedza LaTeXowa wciąż mnie kwalifikuje
do miana początkującego (no, może false begginer, jak to określają
w szkołach językowych). Na niektóre pytania jestem w stanie odpowiedzieć
w miarę precyzyjnie, na inne mogę jedynie podać linka do .../doc.html.
Czasem (przynaję ze wstydem) na odczepnego. Gdyby istniało FAQ to dla osoby
zorientowanej w temacie znalezienie fragmentu nie zajęłoby zbyt dużo czasu.
A odpowiedź "poszukaj w dokumentacji/FAQ" różni się od odpowiedzi "FAQ, p.5.2".
W pierwszym przypadku rozumiem, że ktoś może się zniechęcić i potraktować
mnie jak nieużytka. Jeżeli zaś w drugim ktoś mi powie, że mu się nie chce,
to mu niezbyt eleganko odpowiem: FOAD.

Od dłuższego czasu chodzi mi po głowie myśl o czymś w rodzaju bazy wiedzy.
Z podziałem na kategorie, wyszukiwarką, itd, itp. Grześ Sapijaszko
pisał kilka dni temu parę słów na ten temat. Może coś z tego powstanie?

Przy okazji pytanie do Joli: czy serwer, na którym stoi www GUSTu udostępnia
narzędzia, które pomogłby przy tworzeniu takiego FAQ/bazy wiedzy? Mam
na myśli możliwość tworzenia dynamicznych stron WWW (php? modperl?)
oraz jakiś silnik SQLowy.

Pozdrawiam
        Artur
--
Czesiu, jestes bardziej dziwny, niż mi się wydawało
                                                /Joasia/