La opción _pages en Azure DevOps permite agrupar la información del proyecto en carpetas y artículos Markdown. Organizar y estructurar los contenidos debe hacerse teniendo en cuenta el orden lógico de funcionamiento del producto, presentando al usario final.

Crear artículos y contenidos en el proyecto

1. Ingrese a la consola de Azure DevOps, en el menú principal seleccione la opción Repos (repositorio).

2. En el menú encabezado seleccione el repositorio del proyecto/manual en curso. Ejemplo docs-bpd.

⚐ Nota: Antes de modficar el artículo, cree una rama para registrar los cambios. Ver creación de Ramas en un Proyecto

3. Para crear una nuevo artículo, En la vista de información seleccione una carpeta del proyecto en _pages y en la opción more opttions, seleccione New/File.

3. Ingrese el nombre del artículo y haga clic en el botón Create.

RECOMENDACIONES:
- El nombre del artículo debe ser corto, claro y corresponder al tema tratado.
- El nombre del artículo debe tener la extensión “.md” (markdown) para ser reconocido al publicar el manual.
- El nombre del artículo No debe tener espacios entre las palabras.
- El nombre del artículo debe estar escrito en minúsculas.
- Para unir palabras del nombre del artículo podrá utilizar guion o raya al piso (- _).
- El nombre del artículo No debe incluir caracteres especiales, ni tildes.

4. En la vista detalle del artículo creado, ingrese el encabezado del documento (Ver Encabezado Artículos y el contenido requerido (imágenes, texto, tablas) y los comentarios respectivos. Haga clic en el botón Commit para guardar los cambios propuestos.

Renombrar Artículo

5. Para renombrar un artículo, en la vista de información seleccione la carpeta _pages y un artículo creado; en la opción more opttions, seleccione rename. Se habilita la ventana para actualizar el nombre del artículo.

Eliminar una Artículo

5. Para eliminar una carpeta, en la vista de información seleccione la carpeta _pages y un artículo creado; en la opción more opttions, seleccione Delete. Se habilita la ventana para eliminar el artículo del repositorio.

6. Después de crear, renombrar o eliminar el artículo, genere el Pull Request para implementar los ajustes en el proyecto.

👆 Importante a Tener en Cuenta

• La correcta gestión de carpetas, artículos e imágenes, epermitea optimizar los procesos actualización, revisión y cambios en el proyecto de documentación.
• Agregar contenido (imágenes, texto, tablas) en un proyecto de Documentación.