Utilizziamo DocBook per tutte le nostre specifiche (e altra documentazione rivolta al cliente). DocBook è un formato XML che ti consente di generare facilmente documenti in qualsiasi formato, incluso PDF, che è il modo in cui distribuiamo le cose ai clienti per farli firmare. Possiamo dividere un documento in file (per sezione) e trasferire tutto al nostro sistema di controllo del codice sorgente (Subversion). Poiché è tutto XML (vale a dire basato su testo), la fusione automatica e la risoluzione dei conflitti di Subversion funzionano alla grande se due persone lavorano sullo stesso file. Abbiamo un set di fogli di stile che tutti i nostri documenti utilizzano, quindi tutti i documenti condividono lo stesso stile/formato, senza alcun lavoro aggiuntivo da parte nostra.
E se non ti piace modificare direttamente i file XML, ci sono front-end della GUI che forniscono un'esperienza di tipo WYSIWYG. Credo che la maggior parte delle persone nel mio ufficio utilizzi XMLMind. Tuttavia, siamo tutti persone tecniche, quindi se dovessimo scrivere direttamente XML non sarebbe un problema.
Come sidenote, abbiamo anche pubblicato le note di rilascio. Abbiamo alcuni XSLT che ci permette di scrivere documenti come questo:
<bugs>
<bug id="1234" component="web">JavaScript error when clicking the Kick Me button</bug>
</bugs>
Abbiamo poi uno script che viene eseguito tramite il nostro repository Subversion facendo un svn log
dal tag versione precedente al tag versione corrente, e un po 'integrazione Bugzilla automaticamente generare note di rilascio al volo.
(anche, per la maggior parte interna unica documentazione, usiamo MediaWiki, che è anche un ottimo modo per collaborare.)
fonte
2009-06-28 09:40:24
@JP: diresti che WSS 3.0 (la versione "libera" di SharePoint) è più o meno buono come MOSS 2007 per quanto riguarda questo tipo di collaborazione è interessato? –
Per la pura collaborazione documentale, sì. Ma se vuoi cose come wiki, blog, portali, gestione delle presenze (server di comunicazione), hai bisogno dell'intero MOSS della barca. –
Ho usato blog e wiki in WSS 3.0, la versione fornita con TFS. –