Forum libero

- Scritto da: avvelentani
>
> - Scritto da: Avve DeLarge
> > non necessariamente.
> > dipende anche da quanto spinge il capo a fare un
> > lavoro di documentazione che è
> > palloso.
>
> di solito zero. di solito si fa solo per roba che
> viene rilasciata a
> terzi
>

qed

> > Ne hai scritta di documentazione?
>
> poca.
>
> > Hai cercato di farla con tutti i crismi del
> caso?
>
> ovviamente no
>
> > Lo faresti aggratisse?
>
> l'interfaccia del motorino dei troll l'ho sempre
> documentata a gratiss (stronzi, non mi avete
> mai pagato un centesimo
> )
>

hai fatto il tuo dovere

> >
> > Ora lo so che OS e gratis non sono sinonimi, ma
> > de facto spesso accade così. Poi tra queste
> > considerazioni e il fatto che mi installo linux
> e
> > trovo l'help on line metà in inglese e metà
> > tradotto con babelfish, insomma qualche
> > perplessità sul modello di sviluppo adottato da
> > certi progetti os me la
> > faccio.
>
> vabbe', la traduzione non esiste. in informatica
> esiste solo
> l'inglese.
>

se esiste solo l'inglese lascia la cosa in inglese ed è anche meglio. Tradurla alla cazzo di cane e in maniera incompleta imho è peggio. O no?

> > > Alla fine pero` la documentazione finisce
> sempre
> > > e se non ci sono i sorgenti ti attacchi al
> > > cazzo.
> > >
> >
> > semplicemente non è previsto che tu utilizzi
> > determinate cose.
>
> o che utilizzi le cose in un certo modo
> particolare.

non è mai previsto che utilizzi le cose in un certo modo particolare non previsto.

> ma non e` una gran consolazione
> quando ti trovi a doverlo
> fare.
>

è qua che ti sbagli. Non esiste il "doverlo fare". Se non è previsto che tu lo faccia, o lo fai comunque perché tutto sommato ti conviene, calcolando tutte le difficoltà del caso, oppure trovi un'altra strada (compresa, nel caso specifico delle librerie, rimboccarti le maniche e scriverti le tue).

> > Da questo pdv ovviamente l'os
> > ha una marcia in più, visto che -almeno in
> > teoria- non sottrae nulla e aggiunge
> informazioni
> > che chi non ha voglia di analizzare le ignora e
> > chi ha invece l'interesse di spulciare,
> > spulcia.
> >
> > in pratica, la mia esperienza a riguardo è
> > estremamente nulla, ma l'impressione che ne
> > ricavo è che in media il fatto che ci siano i
> > sorgenti è preso come scusa per non scrivere
> > nient'altro e fare le cose più per sé stessi che
> > per l'utente
> > finale.
> >
>
> no, non penso. come ti ho detto mi sembra piu`
> una questione di diffusione e di cultura (i
> perlisti documentano di solito bene,

ci credo, è un linguaggio di merda, se non documentassero si dimenticherebbero gli autori stessi di cosa fa il loro codice!

> i javisti
> scrivono diligentemente tutti i javadoc ma se ne
> sbattono di darti una visione d'insieme, i c-isti
> fanno la manpage quando gira bene, i c++isti sono
> a meta` tra i c-isti e i javisti -- la meta`
> sbagliata,
> purtroppo)
>

a parte la battutaccia di cui sopra, alla fine secondo me più che di cultura si tratta di vantaggi.
La doc a chi serve? Io mettendomi nei panni di un programmatore (freelance e senza capo che mi dice di scrivere la doc ammodino!), la doc la scriverei principalmente per non dovermi rileggere il sorgente. Ovvio che la faccio a modo mio e per mia utilità.
Non so come questo si concilia con le tue osservazioni empiriche sul rapporto tra il linguaggio usato e lo zelo nel documentare il lavoro, comunque imho una parte ci sta che è la presunzione o meno del padre del codice di riuscire a ricordarsi o di rendere chiaro ad un esterno della funzione del codice semplicemente tramite il sorgente e le eventuali note.

se scrivessi robe solamente in linoleum ad esempio penso che la documentazione la faresti perfetta prima di tutto per te stesso, per risparmiarti lo sbattone di dover rileggerti il source tra qualche anno.