On Wed, Aug 08, 2007 at 07:26:11AM +0200, Luca Brivio wrote: > > One of the biggest problems we experienced is that the existing > documentation, > albeit useful and rather rich, is not coherent. I think we need something > more homogeneous, backed by an overall design. This would not be > yet-another-document to read, instead would substitute many other small > (often out-of-date or contradictory) documents about major and minor topics. > The idea is that one might maintain packages without having a lot of > documents around all the time, just with a big manual which links to other > documents only for reference. It seems likely that most of this manual > already exists, and could be put together, edited, expanded and integrated > with the permissions of its authors, or thanks to its licensing. One of main > goals is to have a truly organic documentation. > > I don't know if such a project deserves to be official, however I wish to try > to make it work, and see how it might work. >
L'idea di un meta manuale semplifica le cose, ma tende anche a incasinarle ulteriormente perche' comunque bisogna mantenerlo, unitamente al resto della documentazione, per esempio gli url tendono a cambiare piuttosto spesso. Inoltre su certe 'risorse' non tutti sono d'accordo, per esempio la doc sulle shared libs versioning e compagnia per quanto valido non e' accettato in toto dagli ftpmasters e si rischia quindi di far passare per ufficiali cose che non lo sono completamente. Io sono piu' dell'idea di integrare i documenti esistenti e ottenere il consenso sul merge di informazioni non ancora presenti da altre fonti. -- Francesco P. Lovergine -- Per REVOCARE l'iscrizione alla lista, inviare un email a [EMAIL PROTECTED] con oggetto "unsubscribe". Per problemi inviare un email in INGLESE a [EMAIL PROTECTED] To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]