Conseguir que los desarrolladores utilicen una wiki [cerrado]

Question

Trabajo en una aplicación compleja donde diferentes equipos trabajan en sus propios módulos con cierto grado de superposición.Hace un tiempo configuramos una instancia de Mediawiki, en parte por indicación mía.Me resulta difícil lograr que la gente realmente lo use, y mucho menos contribuya.

Puedo ver muchos beneficios en compartir información.Al menos puede reducir las veces que reinventamos la rueda.

La wiki no está muy estructurada, pero no estoy seguro de que eso sea un problema siempre que puedas buscar lo que necesitas.

¿Alguna pista?

Answer 1

Como he mencionado antes, un Wiki está muy desorganizado.

Sin embargo, si ese es el único argumento de sus desarrolladores, entonces invierta un poco de esfuerzo en crear una página de índice simple y mantenerla actualizada (hágalo usted mismo o pida a las personas que vinculen sus contribuciones al índice).De esa manera, la Wiki podría convertirse en una colección de documentación muy agradable y bastante completa para todo su trabajo.

Answer 2

Algunos consejos:

Cada vez que alguien envíe información por correo electrónico que realmente debería estar en una wiki, cree una página para ese tema y agregue lo que puso en el correo electrónico.Luego responda "Gracias por esa información. La puse aquí en la wiki para que sea más fácil de encontrar en el futuro".

Del mismo modo, si tiene información que necesita compartir y que debería estar en la wiki, colóquela allí y simplemente envíe un correo electrónico con un enlace, en lugar de enviar un correo electrónico a las personas.

Cuando solicite información a las personas, exprese de manera que colocar dicha documentación en el wiki se considere predeterminado o estándar:"Busqué en la wiki pero no pude encontrarlo.¿Ya subiste esa información?"

Si eres el "campeón de la wiki", asegúrate de que otras personas sepan cómo utilizarla, p."¿Ya he explicado cómo crear una nueva página contigo?"

Edite la barra lateral para asegurarse de que sea relevante para su trabajo.

Utilice plantillas de estilo de "cuadro de navegación" en páginas relacionadas para facilitar la navegación.

Coloque algo como {{Special:NewPages/5}} en la página principal, o cambios recientes, para que las personas puedan ver la actividad.

Eche un vistazo a los cambios recientes cada pocos días o semanas, y si nota que alguien agrega información sin que se lo pidan, envíele un correo electrónico o visítelo y hágale un pequeño cumplido.

Answer 3

Hemos estado usando un wiki de una forma u otra desde hace un tiempo, pero a la gente le lleva un tiempo incorporarse.Es posible que descubras que serás el único que escriba artículos durante algún tiempo, pero ten paciencia, eventualmente se sumarán otras personas.

Si alguien envía un correo electrónico que contiene información relacionada con el proyecto, indíquele amablemente la dirección de la wiki, y siga haciéndolo, debería captar la pista.

Tenemos un portal de SharePoint y usamos el wiki desde allí; lo personalizamos con nuestra propia marca para que "se vea bien". Realmente siento que esto ha ayudado a mejorar su aceptación.

Asegúrese de que todos sepan que el wiki es incluso más informal que el correo electrónico...porque habrá un "factor de miedo" de que la gente piense que cualquier cosa que agreguen al wiki será sobreanalizada.

Answer 4

Creo que la mayoría de las respuestas hasta ahora son acertadas: cuanto más lo utilices, mayor será el conjunto de información útil, por lo que, de forma lenta pero segura, la gente comenzará a utilizarlo de forma natural.

El otro enfoque que podría utilizar es este:Sugiera que cada vez que alguien le haga una pregunta a otro miembro del equipo sobre el proyecto, debe responder la pregunta normalmente, pero también agregar la respuesta a una sección de la Wiki.Esto puede llevar unos minutos más, pero significará que la próxima vez que alguien haga la misma pregunta (lo que inevitablemente hará), podrá ahorrar tiempo señalándolo a la Wiki.Esto, a su vez, debería ayudar a la gente a empezar a utilizar la Wiki como primera fuente de información y contribuir a su aceptación general.

Answer 5

No se puede obligar a los desarrolladores a hacer algo para lo que no tienen un incentivo;desafortunadamente los wikis, como documentación (bueno, de hecho los wikis son documentación) rara vez tienen algún valor "interesante" para los desarrolladores.Además, ya están inmersos en el trabajo de desarrollo. ¿Realmente podrías molestarlos con una wiki?

Dicho esto, las personas que impulsaron la wiki (por ejemplo, usted) deberían ser los principales responsables de actualizarla, y realmente tendría mucho trabajo por delante si se lo toma en serio.

También puedes probar el ff:

• Dices que no está muy estructurado: mucha gente se desanima de los wikis mal estructurados (difíciles de buscar/navegar).Así que tal vez puedas arreglar eso primero.
• Tal vez pueda pedirles a los desarrolladores principales/gerentes de proyectos que lo completen con cosas que les resulten problemáticas:cosas como convenciones de código y diseño de API para su proyecto particular
• Predicar con el ejemplo:documento religioso su parte del sistema.Sentar un precedente puede alentar a otros a hacer lo mismo

Answer 6

Vender la idea de utilizar la wiki a los desarrolladores.Ha identificado algunos beneficios, compártalos con los desarrolladores.Si ven que obtendrán algo de valor, empezarán a utilizarlo.

Ejemplos de ventajas de ¿Qué es una wiki?

• Bueno para escribir ideas rápidas o más largas, lo que le brinda más tiempo para escribir y editar formalmente.
• Colaboración instantánea sin enviar documentos por correo electrónico, manteniendo al grupo sincronizado.
• Accesible desde cualquier lugar con una conexión web (si no le importa escribir en formularios de texto del navegador web).
• Su archivo, porque se conserva cada revisión de página.
• Emocionante, inmediato y empoderador: todos tienen voz y voto.

Answer 7

He realizado algunas ventas e incluso he realizado algunas sesiones de formación.Creo que algunas personas se sienten desanimadas por la falta de edición WYSIWYG y la capacidad de pegar texto formateado desde Word o Outlook.Sé que existen algunas herramientas para solucionar estos problemas, pero siguen siendo barreras.

Hay algunas áreas donde el wiki se utiliza para registrar ciertas áreas, pero las personas que las actualizan no hacen nada más con él.

Usaré la wiki para documentar mi área especializada de todos modos, ya que actúa como una extensión conveniente del cerebro.Cuando comienzo un nuevo desarrollo lo uso como un bloc de notas para ideas que puedo ampliar a medida que avanza.

Sería útil que la dirección le diera algún apoyo vocal, incluso si no se hace obligatorio.

Answer 8

Me resulta difícil lograr que la gente realmente lo use, y mucho menos contribuya.

Una de las formas más fáciles de lograr que las personas contribuyan a un wiki es hacer que proporcionen contenidos de una manera adecuada para el wiki, es decir,de modo que todo lo que publiquen utilizando sus canales habituales de comunicación (grupos de noticias, listas de correo, foros, rastreadores de problemas, chat) sea básicamente adecuado para su inclusión en la wiki.

Para que otros (usuarios/voluntarios) puedan simplemente tomar dichos contenidos y ponerlos en la wiki.

Esto suena más complicado de lo que realmente es, se trata principalmente de generalizar preguntas y respuestas, de modo que no sean necesariamente parte de una conversación, pero que puedan ser comprensibles, significativas y útiles de forma independiente.

Por ejemplo una pregunta como la siguiente:

¿Cómo consigo que git clone un repositorio remoto?

Se puede responder así:

Hola, solo usa Git Clone git: // ...

Pero las preguntas también pueden responderse con un estilo menos personal:

Para clonar un repositorio de git, querrás usar el parámetro clone para git:git clon git://....

Lo que intento decir es que la mayoría de las discusiones en un proyecto pueden y deben usarse fácilmente para convertirse eventualmente en documentación.Con este tipo de mentalidad, su documentación puede crecer con bastante rapidez.Sólo necesita que la gente tenga en cuenta que lo ideal es que la información útil se proporcione de una manera que sea adecuada para su inclusión en wiki.

He sido testigo de varios casos en los que proyectos de código abierto comenzaron a utilizar este enfoque hasta cierto punto y, aunque algunas personas (en su mayoría usuarios nuevos) se quejaron de que las respuestas no eran muy personales, el conjunto de documentación aumentaba constantemente, porque otras personas simplemente monitoreaban dichas discusiones y Comencé a copiar/pegar dichas respuestas en la wiki.

Básicamente, esta es una de las formas más fáciles de lograr que las personas contribuyan a un wiki, sin necesidad de que lo usen ellos mismos, lo único que se requiere de ellos es un cambio de forma de pensar.

Answer 9

Si los desarrolladores aún necesitan mantener documentación "real" (por ejemplo,documentos de Word), no veo ninguna manera de duplicar eso de manera significativa en un Wiki.

• No tiene sentido que la gente escriba dos veces
• Es probable que cualquier dato duplicado se desincronice pronto.

Lo que ha hecho mi cliente actual es mover todo esto a Wiki.Así que sólo documento una vez y lo hago. en la wiki.

Esto está bien.Trabajar con Wiki es más tedioso que con Word, pero al menos el documento está en línea y otros pueden mezclarlo y combinarlo.

Otra solución funcional (en mi humilde opinión) sería almacenar documentos junto con la fuente, en subversion.Pero entonces el sistema de fusión debe poder soportar texto enriquecido, etc.también.No sé si existe alguna solución para eso (aparte de usar HTML o LaTex, que en realidad no serían malas opciones).

Answer 10

Encuentra elementos "pegajosos" (sub-3 pág.documentos/diagramas/etc) algo que el equipo parece estar creando una y otra vez y publicarlo en la wiki.Asegúrese de que todos tengan acceso al wiki y sepan que está ahí; configure un mecanismo de notificación si es posible.Con un poco de suerte, la próxima vez que tengan que acceder, en lugar de sacarlo del control de versiones o de sus máquinas, deberían acceder a la wiki.Si aún no lo hacen, intente ver si el equipo tiene suficiente margen de maniobra para usar realmente el wiki; es posible que detrás de su desgana se encuentren problemas más sutiles.

Answer 11

Echa un vistazo a los consejos en http://www.ikiw.org/ Haz crecer tu wiki

Answer 12

Sólo para agregar a algunos de los excelentes consejos que se ofrecen aquí...

Como desarrollador en una pequeña empresa que realiza principalmente trabajos por contrato con el gobierno en el rango de 6 a 24 meses, encuentro que mi tiempo a menudo se divide entre el desarrollo y la redacción de informes de estado (¡a la altura de la redacción de documentación, solo que peor!). una wiki para eliminar pensamientos y notas desorganizadas a medida que avanzamos ha hecho que la redacción de informes sea mucho menos dolorosa (no menos dolorosa, pero mejor de todos modos).

Además, si ya estás en el mundo de Mediawiki, es posible que desees consultar SemánticaMediawiki.Te permite llevar la organización de tus datos a otro nivel etiquetándolos semánticamente.Eso no significa mucho por sí solo, lo sé, pero puedo decirles (por ejemplo) que puede mejorar drásticamente la relevancia de los datos devueltos por las búsquedas.Definitivamente vale la pena echarle un vistazo.

Answer 13

En general, buenos consejos aquí.Me gustaría agregar:

1. De verdad necesidad a campeón - alguien empujando esto a los desarrolladores y a la gerencia (sin ser molesto ¡Eso es un desafío!) y brindando soporte y tutoriales cuando sea posible.Esta persona también debe ser un compañero (es decir, un compañero desarrollador, no alguien en un departamento de TI remoto) y estar realmente centrado en el cliente, es decir,Listo para realizar cambios cuando se le solicite.
2. Hablando de cambios, algunas personas aquí dicen los wikis no están estructurados.No estoy de acuerdo.Nuestra instalación de MediaWiki está estructurada mediante categorías, particularmente con dos extensiones:AdvertirNoCategorías (para requerir que los usuarios agreguen una categoría al guardar una página) y CategoríaÁrbol para mostrar cómo encajan todas las categorías (esto se puede vincular desde la barra lateral).Tengo más consejos sobre cómo mantener este umbral bajo, si está interesado.