Ottenere gli sviluppatori a utilizzare un wiki [chiuso]

Question

Io lavoro su un'applicazione complessa in cui diverse squadre di lavoro su loro moduli con un grado di sovrapposizione.Qualche tempo fa abbiamo avuto un Mediawiki istanza di impostare, in parte, a mio suggerimento.Ho un lavoro difficile convincere la gente a usare, figuriamoci contribuire.

Posso vedere un sacco di benefici per la condivisione delle informazioni.Si può almeno ridurre i tempi che reinventare la ruota.

Il wiki non è molto strutturato, ma non sono sicuro che è un problema di tempo, come si può cercare ciò di cui hai bisogno.

Suggerimenti?

Answer 1

Come ho già detto prima, un Wiki è molto disorganizzati.

Tuttavia, se questo è l'unico argomento da sviluppatori, quindi investire un po ' di sforzo per creare una semplice pagina di indice e tenerlo aggiornato (farlo da soli o chiedere alla gente di collegare i loro contributi all'indice).In questo modo, il Wiki potrebbe crescere in un ambiente molto bello e abbastanza completa raccolta di documentazione per tutto il vostro lavoro.

Answer 2

Alcuni consigli:

Ogni volta che qualcuno invia informazioni via e-mail che in realtà dovrebbe essere in un wiki, fare una pagina del topic e aggiungere quello che hanno messo in e-mail.Quindi la risposta "Grazie per la info, ho messo in wiki qui in modo che sia più facile trovare in futuro."

Allo stesso modo, se si dispone di informazioni di cui hai bisogno per condividere che dovrebbe essere in un wiki, l'ha messo lì e basta inviare una e-mail con un link ad esso, piuttosto che e-mail di persone.

Quando si chiede alla gente per l'informazione, la frase in modo che l'inserimento di tale documentazione nel wiki deve essere considerato il valore di default o standard:"Ho cercato nel wiki ma non riuscivo a trovare.Hai messo che informazioni su c'è ancora?"

Se siete il "wiki campione", fare in modo che altre persone sanno come usarlo, ad esempio"Mi ha fatto passare attraverso come creare una nuova pagina con voi ancora?"

Modificare la barra laterale per assicurarsi che sia rilevante per il vostro lavoro.

Utilizzare "nav casella" modelli di stile sulle relative pagine per facilitare la navigazione.

Mettere qualcosa come {{Speciale:NewPages/5}} in prima pagina, o a recenti modifiche, in modo che la gente può vedere l'attività.

Prendere un peek a Recenti modifiche ogni pochi giorni o una settimana, e se si nota qualcuno aggiunta di informazioni senza essere spronato, inviare loro una e-mail o un salto e dare loro un po ' di complimento.

Answer 3

Abbiamo usato un wiki, in una forma o un altro per un po 'ora, ma ci vuole un po' per le persone a bordo.Si potrebbe scoprire che è l'unico a scrivere articoli per un certo tempo, ma portare con sé, per altri sarà venuto a bordo alla fine.

Se qualcuno invia una mail in giro che contiene le informazioni relative al progetto, quindi utilmente il loro punto in direzione del wiki - e continuiamo a farlo - si dovrebbe ottenere il suggerimento.

Abbiamo un sito di SharePoint portal e usare la wiki da lì abbiamo personalizzato con il proprio marchio in modo che "sembra la parte" - mi sento veramente a ciò ha contribuito a migliorare l'assorbimento di esso.

Assicurarsi che tutti sono a conoscenza che il wiki è ancora di più informale rispetto e-mail....perché ci sarà un "fattore paura" che la gente può pensare nulla di che aggiungere al wiki verrà analizzato.

Answer 4

Penso che la maggior parte delle risposte finora sono a posto, più si collega a te, il più grande corpo di informazioni utili per diventare, così, lentamente, ma sicuramente, la gente sarà naturalmente cominciare ad usare.

L'altro approccio che si potrebbe usare è questo:Suggerisco che ogni volta che qualcuno chiede un altro membro del team una domanda sul progetto, si deve rispondere alla domanda come è normale, ma aggiungere anche la risposta a una sezione del Wiki.Questa operazione potrebbe richiedere alcuni minuti, ma vorrà dire che la prossima volta che qualcuno chiede la stessa domanda (che, inevitabilmente sarà), è possibile risparmiare tempo puntando al Wiki.Questo, a sua volta, dovrebbe aiutare la gente a iniziare a utilizzare il Wiki come prima fonte di informazioni e di aiuto complessivo di up-take.

Answer 5

Non posso costringere gli sviluppatori a fare qualcosa che non si dispone di un incentivo di utilizzo per;purtroppo wiki, come la documentazione (beh, in effetti wiki sono la documentazione) raramente hanno alcun "cool" valore per gli sviluppatori.Inoltre, sono già in profondità nel dev lavoro-potrebbe davvero preoccuparsi di loro con un wiki?

Detto questo, le persone che hanno spinto per la wiki (ad esempio, si) dovrebbe essere principalmente responsabili per l'aggiornamento, e davvero si potrebbe avere un sacco di lavoro per voi, se siete seri su di esso.

Si potrebbe anche provare l'ff:

• Non è molto strutturato dire-un sacco di persone spento da poco strutturati (hard-di-ricerca/navigazione) wiki.Così forse si può rimediare prima
• Forse si può chiedere a portare gli sviluppatori/project manager per riempirlo con le cose che sono problemi loro:cose come il codice di convenzioni e di progettazione di API per il vostro progetto particolare
• Esempio:religiosamente documento il parte del sistema.La creazione di un precedente potrebbe incoraggiare altri a fare lo stesso

Answer 6

Vendere l'idea di usare il wiki per gli sviluppatori.Hai individuato alcuni vantaggi, condividere con gli sviluppatori.Se vedono che si ottiene qualcosa di valore fuori di esso inizieranno a utilizzarlo.

Esempio vantaggi da Che cosa È un Wiki

• Buona per scrivere idee rapide o quelli più lunghi, dando più tempo per formale di scrittura e di editing.
• Immediatamente collaborativo senza invio documenti, mantenendo il gruppo in sincronia.
• Accessibile da qualsiasi luogo con una connessione a internet (se non ti dispiace scrivere in web-browser forme di testo).
• L'archivio, perché ogni pagina di revisione è tenuto.
• Emozionante, immediato, e consentendo--ognuno dice la sua.

Answer 7

Ho fatto qualche vendita e anche eseguire alcune sessioni di formazione.Penso che alcune persone sono disattivati per la mancanza di editing WYSIWYG e la capacità di incollare il testo formattato da Word o Outlook.So che ci sono alcuni strumenti per lavorare intorno a questi, ma sono ancora le barriere.

Ci sono alcune zone in cui il wiki viene utilizzato per accedere a determinate aree, ma le persone che aggiornare quelli non si fa niente di diverso con esso.

Io utilizzo il wiki per documentare il mio spazio specializzato indipendentemente da come esso agisce come un comodo cervello estensione.All'inizio di un nuovo sviluppo lo uso come un blocco note per le idee che ho, è possibile espandere su come procede.

Sarebbe d'aiuto se la gestione vorresti dare un po ' di supporto vocale, anche se non è obbligatorio.

Answer 8

Ho un lavoro difficile convincere la gente a usare, figuriamoci contribuire.

Uno dei modi più semplici per ottenere le persone a contribuire a un wiki, è effettivamente in possesso di loro fornire i contenuti all'interno di un wiki-moda adatta, vale a direin modo che qualsiasi post con il loro consueti canali di comunicazione (newsgroup, mailing list, forum, issue tracker, chat), è fondamentalmente adatto per l'inserimento sul wiki.

Così che altri utenti/volontari) può semplicemente prendere tali contenuti e metterli sul wiki.

Questo sembra più complicato di quello che realmente è, è soprattutto su di generalizzare domande e risposte, in modo che essi non sono necessariamente parte di una conversazione, ma può essere comprensibile, utile e significativa in una autonoma di moda.

Per esempio una domanda come la seguente:

come posso ottenere il git clone di un repository remoto???

Può essere una risposta come questa:

Ciao, Usare git clone git://...

Ma le domande possono anche essere risposto in meno di un stile personale:

Per clonare un repository git, si desidera utilizzare il clone parametro di git:git clone git://....

Quello che sto cercando di dire è che la maggior parte delle discussioni in un progetto può e deve essere facilmente utilizzato per diventare documentazione eventualmente.Con questo tipo di mentalità, la documentazione può effettivamente crescere piuttosto rapidamente.Hai solo bisogno di convincere la gente a tenere a mente che le informazioni utili dovrebbe essere idealmente fornito in un modo che è adatto per il wiki di inclusione.

Ho assistito a diversi casi in cui i progetti open source iniziato a utilizzare questo approccio in qualche misura e mentre alcune persone (in gran parte per i nuovi utenti) si lamentava che le risposte non sono state molto personale, il corpo di documentazione è stato in costante aumento, perché la gente semplicemente monitorati tali discussioni e ha iniziato a copiare/incollare le risposte, per il wiki.

Fondamentalmente, questo è uno dei modi più semplici per ottenere le persone a contribuire a un wiki, senza la necessita di usare se stessi, l'unica cosa che è richiesto di loro è un cambiamento nel modo di pensare.

Answer 9

Se gli sviluppatori hanno ancora bisogno di mantenere la 'reale' di documentazione (s.un.Documenti di Word), non vedo alcun modo per significativamente duplicato su un Wiki.

• Non ha senso per le persone a scrivere due volte
• Eventuali dati duplicati è inclini a ottenere la sincronizzazione, a presto.

Quello che il mio cliente ha fatto è spostare tutto questo per Wiki.Così ho solo documento di una volta, e io lo faccio su il Wiki.

Questo è bene.Di lavoro con il Wiki è di più noioso che con la Parola, ma almeno il doc è online e gli altri possono abbinare con esso.

Un'altra soluzione di lavoro (imho) sarebbe archiviare documenti a fianco della fonte, sulla sovversione.Ma poi l'unione di sistema deve essere in grado di far fronte con il rich text etc.come bene.Non so, se qualsiasi soluzione che esiste (diverso utilizzando HTML o Lattice, che in realtà non sarebbe male, picconi).

Answer 10

Trovare "sticky" elementi (sub-3 pg.docs / diagrammi / ecc) qualcosa che la squadra sembra essere la creazione di nuovo e di nuovo e post su wiki.Assicurarsi che tutti hanno accesso al wiki e conosce il suo non - istituito un meccanismo di notifica, se possibile.Con un po ' di fortuna, la prossima volta che si dispone di accesso, piuttosto che scavare il controllo della versione o le loro macchine - deve colpire il wiki.Se ancora non, provare a vedere se la squadra ha un gioco sufficiente per usare il wiki più Sottili, i problemi potrebbero trovarsi sotto la loro riluttanza.

Answer 11

Date un'occhiata alla consulenza http://www.ikiw.org/ Far crescere la tua Wiki

Answer 12

Basta aggiungere alcuni degli eccellenti consigli offerti...

Come dev in una piccola azienda che ha in gran parte gov't contratto di lavoro in 6-24 mesi di intervallo, trovo che il mio tempo è spesso diviso tra lo sviluppo e la scrittura di relazioni sullo stato (fino lì con la scrittura di documentazione, solo peggio!!!) Avere un wiki per schiaffeggiare giù disorganizzati pensieri e note con il passare del tempo ha fatto scrivere relazioni molto meno doloroso (non MENO dolore, ma meglio di tutti è la stessa).

Inoltre, se siete già in Mediawiki mondo, si potrebbe desiderare di guardare SemanticMediawiki.Esso consente di eseguire l'organizzazione dei dati in un altro livello da un punto di vista semantico il tagging è.Che non significa un sacco di propria iniziativa, lo so, ma posso dirti (per esempio) che può drasticamente migliorare la pertinenza dei dati restituiti dalle ricerche.È sicuramente la pena dare un'occhiata.

Answer 13

Generalmente un buon consiglio qui.Vorrei aggiungere:

1. Davvero bisogno un campione - qualcuno a spingere questo per gli sviluppatori e di gestione (senza essere invadente - questa è una sfida!) e fornendo supporto e tutorial, quando possibile.Questa persona ha bisogno anche di essere un peer (quindi un compagno di sviluppatori, non di qualcuno in un remoto reparto) e realmente orientato al cliente ovveropronto per apportare le modifiche richieste.
2. A proposito di novità, alcune persone qui dicono i wiki sono strutturati.Io non sono d'accordo.La nostra installazione MediaWiki è strutturato in categorie, in particolare con due estensioni:WarnNoCategories (per richiedere agli utenti di aggiungere una categoria durante il salvataggio di una pagina) e CategoryTree per mostrare come tutte le categorie di bene insieme (questo può essere legato a dalla barra laterale).Ho altri suggerimenti su come mantenere questa soglia bassa, se siete interessati.