Quindi abbiamo uno strumento per la revisione del codice, ora cosa possiamo usare per i documenti software? [chiuso]

2

Usiamo Subversion come un CM completo per il codice e anche per i documenti di progetto correlati. Abbiamo JIRA e Fisheye. Quando volevamo aggiungere uno strumento di revisione tra pari, abbiamo esaminato e testato diversi candidati. I nostri requisiti ponderati comprendevano sia la revisione del codice che quella del documento, ma alla fine, l'integrazione con JIRA ha inclinato i punteggi in favore di Crucible.

Atlassian ha sbattuto la porta su Word o PDF di supporto in Crucible. Ho testato diversi metodi di soluzione per rendere Crucible funzionante per i documenti senza successo. (Il plug-in Confluence / Crucible è stato deprecato da Atlassian, quindi anche questa opzione è disponibile.) Non ho trovato un plug-in per Crucible che aggiunga questa funzionalità, così poco meno di scrivere il mio plug-in, Crucible for documents is impraticabile.

Le modifiche alle tracce di parole non forniscono un metodo per la vera collaborazione e il commento. Adobe PDF Comment e Markup è interessante, ma non fornisce un ottimo modo per mantenere una registrazione permanente della qualità della conversazione. Non possiamo passare al cloud, i nostri documenti devono essere localmente ospitati solo sul nostro server. Siamo solo su Sharepoint 2007.

Aiuto! Qualcuno ha un suggerimento?

    
posta Tini 07.12.2012 - 22:52
fonte

2 risposte

3

Scrap Word o PDF come formato di documento - scrivi invece il tuo codice in ASCIIDoc o ReStructuredText e usalo come fonte per generare documenti PDF / Word. Il vantaggio dell'utilizzo del markup leggero è che puoi scrivere i tuoi documenti come testo vecchio e semplice (che i programmatori vorrebbero come possono farlo all'interno dell'IDE, il che significa che potrebbero farne di più) e le differenze che possono essere generate tra i documenti è un problema risolto. Hai anche il vantaggio di trasformarlo in HTML o nel tuo solito formato per il rilascio.

    
risposta data 08.12.2012 - 01:36
fonte
1

Onestamente, alla fine della giornata ho avuto una fortuna incredibile usando il wiki per collaborare e archiviare qualsiasi tipo di documento che creiamo incluso il wiki stesso come documenti.

    
risposta data 08.12.2012 - 00:16
fonte

Leggi altre domande sui tag