Acerca de wikis, LÉAME y Markdown

Para admitir a su equipo o colaboradores en el proyecto, use Markdown para agregar formato enriquecido, tablas e imágenes al proyecto de equipo. Puede usar el formato Markdown dentro de una wiki de proyecto de equipo, el contenido que agregue a un panel, el archivo LÉAME del proyecto de equipo u otro archivo LÉAME del repositorio.

Para admitir a su equipo o colaboradores en el proyecto, use Markdown para agregar formato enriquecido, tablas e imágenes al proyecto de equipo. Puede usar el formato Markdown en el contenido que agregue a un panel, el archivo LÉAME del proyecto de equipo u otro archivo LÉAME del repositorio.

Wiki

Use la wiki del proyecto de equipo para compartir información con otros miembros del equipo. Al aprovisionar una wiki desde cero, un nuevo repositorio de Git almacena los archivos, las imágenes, los datos adjuntos y la secuencia de páginas de Markdown. Esta wiki admite la edición colaborativa de su contenido y estructura.

Las siguientes características son compatibles con la wiki del proyecto de equipo.

Aprovisionamiento o creación de una wiki

• Creación de una wiki para el proyecto de equipo
• Publicación de código como wiki

Trabajar con contenido wiki

• Adición y edición de páginas de wiki
• Ver el historial de páginas wiki y revertir
• Versión, selección o anular la publicación de una wiki publicada
• Clonación y actualización de contenido wiki sin conexión
• Uso de métodos abreviados de teclado wiki
• Filtrar o imprimir contenido wiki¹

Dar formato al contenido de wiki

• Formato Markdown
• Etiquetas HTML
• Inserción y cambio de tamaño de imágenes
• Vínculo a elementos de trabajo mediante #
• Adjuntar archivos
• Notación matemática y caracteres
• Tabla de contenido (TOC) para páginas Wiki

Las siguientes características son compatibles con la wiki del proyecto de equipo que se crea en la versión de TFS indicada o en versiones posteriores. Para más información, consulte Creación de una wiki para el proyecto de equipo y Adición y edición de páginas wiki.

Publicación de repositorios de Git existentes en una wiki

Muchos equipos documentan su código mediante Markdown y comprueban estos archivos junto con el código. Aunque Git admite el mantenimiento y la revisión de dicha documentación junto con las solicitudes de extracción estándar, estos archivos presentan algunos desafíos a los consumidores del contenido.

• A menudo, los lectores deben realizar una búsqueda a través de muchos archivos y carpetas para encontrar el contenido de interés.
• El contenido carece de organización y estructura. No hay ninguna jerarquía de páginas inherente para admitir lectores.
• No se admite el control de versiones de contenido.
• La búsqueda a través del contenido se basa en la búsqueda del código, en lugar de una experiencia de búsqueda optimizada para buscar contenido.

Con la característica publicar código como wiki, puede publicar uno o varios repositorios de Git definidos en el proyecto de equipo en una wiki. Esta característica proporciona una manera de mantener el contenido junto con la base de código, pero publicar y actualizar de forma selectiva el contenido en una wiki.

Hay diferencias significativas entre cómo administrar el contenido de una wiki que se aprovisiona para un proyecto de equipo y las páginas wiki que se publican desde un repositorio de Git. Para más información, consulte Publicación de un repositorio de Git en una wiki.

Markdown

Markdown facilita el formato del texto e incluye imágenes. También puede vincular a documentos dentro de las páginas del proyecto, archivos LÉAME, paneles y comentarios de solicitud de extracción.

Puede proporcionar instrucciones a su equipo en los siguientes lugares mediante Markdown:

• Wiki del proyecto de equipo
• Publicación de código como wiki
• Adición de Markdown a un panel
• Project página principal o páginas de bienvenida
• Archivos LÉAME del repositorio
• Comentarios de solicitud de extracción

• Adición y edición de páginas de wiki
• Adición de Markdown a un panel
• Project página principal o páginas de bienvenida
• Archivos LÉAME del repositorio
• Comentarios de solicitud de extracción

• Adición de Markdown a un panel
• Project página principal o páginas de bienvenida
• Archivos LÉAME del repositorio
• Comentarios de solicitud de extracción