3.1.10 Agregando una Wiki

Azure DevOps permite a los miembros del equipo escribir artículos, o subir algunos formatos necesarios para trabajar, manuales, etc en una wiki. La idea es compartir información que puede ser útil para todos los miembros del equipo.

Puedes agregar secciones para clasificar el contenido. Algunos ejemplos de categorías son:

  • Información general del sistema, por ejemplo las personas del usuario, algunos diagramas útiles para entender algún concepto propio del negocio, el diagrama de la base de datos, etc.

  • Las reglas de negocio para cada opción del sistema

  • Estándares y buenas prácticas

  • FAQ (Frequently Asked Questions)

  • Cheklist para tener en cuenta los puntos a revisar en tus tareas

  • Manuales y cursos.

Para crear una nueva wiki:

  1. Da clic en Overview -> Wiki y luego en el botón Create project wiki

2. Te muestra una página para agregar un artículo. El formato de escritura es markdown, el cual es texto y mediante algunos códigos por ejemplo agregar texto entre ** te permite poner el texto en negritas

Puedes por ejemplo tener una sección para las personas. Agrega el título, el texto y da clic en Save

Se muestra el artículo agregado. Del lado izquierdo puedes ir agregando las secciones. En la parte inferior puedes agregar comentarios y al final del artículo se muestran las estadísticas de las visitas de los últimos 30 días. También puedes editar el artículo en el botón Edit de laa esquina superior derecha

Agrega una nueva página que se llame Información general, puedes arrastrar la página para que sea la primer página y luego puedes mover la página de Personas dentro de la de Información General.

Cuando mueves una página Azure DevOps revisa que no haya links rotos. Si todo es correcto da clic en Move

Si das clic con el botón derecho del mouse sobre una página puedes ver las opciones disponibles

En el editor puedes agregar cosas interesantes como agregar @ y luego agregar el nombre de algún miembro del equipo o escribir # y escribir el número de tarea, User Story etc. Puedes agregar los resultados de un Query.

Puedes encontrar mas información para crear tu Wiki en la documentación oficial, de momento solo en ingles