[Discussioni]debian weekly news

[Federico Di Gregorio]

Il mer, 2003-04-30 alle 11:50, Christian Surchi ha scritto:

> Uno degli aspetti piu' interessanti della discussione, almeno secondo
> me, e' quello legato non all'esistenza delle invarianti, quanto al fatto
> che non possano essere rimosse. A molti questo sembra inaccettabile, a
> meno che non si tratti di note di copyright o di parti di testo legate
> alla licenza. 
> 
> In piu' sono stati notati anche problemi molto pratici, come il fatto
> che le invarianti possono portare ad un appesantimento della
> documentazione, visto che si possono aggiungere invarianti senza
> problemi... una critica ulteriore e' anche quella a FSF che, a quanto e'
> stato detto, non ho adesso il riferimento preciso, "incoraggia" all'uso
> delle sezioni invarianti (o immodificabili che dir si voglia).
> 
> In alcuni casi le invarianti poi possono rendere il contenuto di un
> documento estremamente obsoleto... e quindi difficilmente
> riutilizzabile. A maggior ragione se, qualcuno lo ha fatto notare,
> avvenga un fork nello sviluppo.

una cosa che molti dimenticano e` che le invariant sections non possono
essere le parti tecniche del documento. in pratica dediche, spiegazioni
sul perche' si e` scritto il documento, pubblicita`, etc. vanno bene, il
resto no. questo, imho, le rende accettabili.

        A "Secondary Section" is a named appendix or a front-matter
        section of the Document that deals exclusively with the
        relationship of the publishers or authors of the Document to the
        Document's overall subject (or to related matters) and contains
        nothing that could fall directly within that overall subject.
        (Thus, if the Document is in part a textbook of mathematics, a
        Secondary Section may not explain any mathematics.) The
        relationship could be a matter of historical connection with the
        subject or with related matters, or of legal, commercial,
        philosophical, ethical or political position regarding them.
        
        The "Invariant Sections" are certain Secondary Sections whose
        titles are designated, as being those of Invariant Section [...]

> I miei sono solo un po' di punti presi qua e la' dalla discussione, tra
> quelli che mi hanno fatto riflettere di piu'... personalmente credo
> anch'io che la documentazione sia una cosa diversa dal software, diversa
> ma strettamente legata al software, soprattutto nel caso del software
> libero! La "perdita" di documentazione e' ancora piu' grave. E poi,
> ripeto, quello che mi fa pensare di piu' e' proprio il fatto che le
> sezioni immodificabili non possano essere rimosse in alcun modo, e non
> semplicemente che esistano... 

io sto scrivendo una guida su come usare la DBAPI-2.0 in python e metto
un'introduzione non-tecnica dove spiego che ogni autore di moduli che
supportano la DBAPI-2.0 e` incoraggiato ad aggiungere un capito con le
peculiarita` del suo lavoro e perche'. io *non voglio* che questa
introduzione venga tolta (magari da qualcuno che pubblica il manuale) e
quindi la rendo invariante. credo lo scopo sia questo e mi trova
abbastanza d'accordo.

-- 
Federico Di Gregorio
Debian GNU/Linux Developer                                fog a debian.org
INIT.D Developer                                           fog a initd.org
  The devil speaks truth much oftener than he's deemed.
   He has an ignorant audience. -- Byron (suggested by Alice Fontana)
-------------- parte successiva --------------
Un allegato non testuale è stato rimosso....
Nome:        signature.asc
Tipo:        application/pgp-signature
Dimensione:  189 bytes
Descrizione: non disponibile
URL:         <http://lists.softwarelibero.it/pipermail/discussioni/attachments/20030430/f7166c23/attachment.sig>