Sto cercando un wiki o un sistema simile a una wiki per scrivere e gestire le specifiche e la documentazione per un progetto software.
So che ci sono molte implementazioni wiki disponibili, ma ce ne sono alcune che sono particolarmente adatte per questo tipo di attività?
In realtà non deve essere un wiki, solo un sistema che semplifica la scrittura e la navigazione di specifiche e documentazione e supporta la modifica delle modifiche.
Usiamo LaTeX e SVN. Dal momento che i documenti LaTeX sono solo file di testo, funziona bene con il controllo della versione, a differenza di alcuni formati binari o parzialmente binari.
Ottieni tutti i vantaggi (e gli svantaggi, ammettiamolo) del controllo di versione a cui sei abituato di utilizzarlo con il tuo codice.
LaTeX richiede un po 'di impostazione (per definire i tuoi stili / classe), ma una volta fatto è molto buono - puoi concentrarti esclusivamente sul contenuto piuttosto che sulla sua presentazione (piuttosto che essere tentato di modificarlo costantemente come sei con WYSIWYG), ma alla fine ottieni comunque un documento in formato PDF dall'aspetto professionale.
Personalmente, mi piace molto Tiddly Wiki .
Ha una sintassi wiki abbastanza completa, è un singolo file html autonomo e funziona bene con una varietà di browser web senza la necessità di un server.
Ha persino un'architettura plug-in estensibile che ti consente di aggiungere plug-in per fare ogni sorta di cose interessanti come criptare i tiddler o aggiungere note a piè di pagina.
Per la piattaforma Microsoft, l'integrazione TFS (Team Foundation Server) con SharePoint è proprio quello che stai cercando. Creando un nuovo progetto di squadra, puoi scegliere un modello che comprenda quasi ogni aspetto del processo di sviluppo del software. Ti offre un portale in cui puoi definire i membri del team, assegnare i loro ruoli e le autorizzazioni di sicurezza, caricare, condividere e modificare documenti e specifiche relative al tuo progetto, e fare molte altre cose interessanti con esso.
Per altre piattaforme, penso che tu possa utilizzare qualcosa come GitHub (anche se non ne sono sicuro)
Per il progetto personale (esistente solo sul mio PC) uso Wiki in un barattolo . In passato ho lavorato con Redmine (ha inoltre un sistema di tracciamento dei bug e SCM)
Potresti provare Sphinx , con i documenti controllati nell'infrastruttura di gestione del controllo sorgente di tua scelta. Questo ha i vantaggi del controllo del codice sorgente e un linguaggio di markup relativamente leggero, reStructuredText , che è facile da apprendere e abbastanza ben strumentato per conversioni (in HTML, in PDF e così via).
Leggi altre domande sui tag specifications wiki