Come posso gestire un repository centrale di documentazione?

2

Il nostro team lavora con un gran numero di API e servizi diversi e abbiamo anche i nostri strumenti e servizi interni che manteniamo. Al momento, non disponiamo di un buon sistema gestito centralmente per elencare quali progetti abbiamo utilizzato una determinata API o per allegare documentazione per tutte le nostre utilità / apis.

Credo che quello che sto cercando sia un qualche tipo di wiki del team, ma non siamo rimasti colpiti dalla capacità di ricerca della soluzione che abbiamo provato (Sharepoint).

I wiki sono il modo giusto per avvicinarsi alla documentazione centralizzata? Che tipo di cose dovrei cercare quando creo un sistema di documentazione centralizzato?

    
posta Kyle Ballard 04.05.2011 - 18:18
fonte

1 risposta

1

Un wiki è un approccio eccezionale per centralizzare la documentazione in modo organico .

Naturalmente, "organico" implica flessibilità, ma anche la possibilità di creare confusione. In un ambiente di sviluppo, con poche semplici policy in atto, è un posto perfetto per ogni sviluppatore per contribuire, piuttosto che avere i documenti sparsi su dispositivi di archiviazione o inseriti in una cartella condivisa.

I tipi di cose che stavamo cercando erano:

  1. Integrazione con autenticazione utente esistente
  2. Autorizzazione flessibile in modo da poter consentire ai client e partizionare i team di sviluppo
  3. Compatibilità con i documenti di Office per soddisfare i PM: (

Abbiamo finito per utilizzare Confluence e lo adoro. Spero che ti aiuti!

    
risposta data 20.05.2013 - 16:02
fonte

Leggi altre domande sui tag