¿Cómo gestionan las empresas de desarrollo de software las empresas o la documentación de un gran proyecto editada por varias personas? ¿Es con Git?

No, no usan Git. Por lo general no pueden.

¿Por qué? Porque -por lo general- escriben los documentos con Microsoft Word, y la fusión no funciona con formatos binarios. Por lo tanto, confían en las herramientas de diferencias integradas de Word (que tienen serias limitaciones).

Por supuesto, esto resulta en un desastre horrible porque solo una persona puede editar el documento de Word a la vez o es una pesadilla combinada … Para evitar problemas, a veces usan un sistema de gestión de documentos, que solo permite que UNA persona edite un archivo a la vez. hora. Esas herramientas son siempre horribles de usar, lentas y con interfaces de usuario terribles.

Sin embargo, una vez vi a un equipo que escribió la documentación de los usuarios no con Word sino con un editor XML (texto). Esto les permitió formatear fácilmente su documento final. Los resultados parecieron impresionantes. Era mucho mejor que Word. Podrían haber usado Git. Pero no lo hicieron porque los documentos fueron editados por una sola persona … (Lo sé, Git es útil incluso cuando estás solo).

Utilizan sistemas de gestión de contenido y / o Wiki, que son muy buenos para administrar, almacenar contenido y, como mencionó, manejar múltiples niveles de permisos (autores, gerentes, usuarios finales, etc.).

Pueden usar Git para almacenar su código que construye todo el sistema (junto con CMS) o solo su código personalizado que se ejecuta en la parte superior de cualquier cms.

Algunos ejemplos:

  • Adobe utiliza su propio WebCMS – AEM para la documentación de sus productos, como Adobe Experience Manager 6.3 (sí, sobre AEM basado en AEM)
  • La confluencia es muy utilizada popularmente por las empresas
  • Wiki internos como DocuWiki,
  • SharePoint (también se usa para almacenar y compartir documentos de proyectos en toda la organización)
  • Hay varias herramientas de documentación de proyectos simples basadas en rebajas también en el mercado, como GitHub Pages, Readme.io, etc.

Desarrollador Manager aquí!

No es fácil ya que hay diferentes tipos de documentación.

La documentación del código generalmente se maneja dentro del código como comentarios, por lo que git se encarga de ello.

Mi empresa utiliza productos Atlassian, por lo que guardamos especificaciones, documentos de usuario y cosas de “alto nivel” en Confluence.

Los documentos de trabajo reales se rastrean en Jira, ya que generalmente está relacionado con tareas.

La mayoría de las compañías usarán una variación de este enfoque, dependiendo de su nivel de organización y herramientas que usen.

Dicho esto, trabajé para empresas donde la mayoría de los documentos se guardaban en el buzón de cada uno … 😉

Git es una herramienta para administrar archivos de texto (por ejemplo, código) pero no los archivos binarios (por ejemplo, palabra, presentación, hoja de cálculo, PDF, etc.). Como la mayor parte de la documentación está escrita en archivos binarios, Git puede no ser una muy buena opción.

Si la documentación se mantiene en formato de texto (generalmente XML y luego aplica una hoja de estilo para crear un archivo binario), entonces podría usarse Git pero los archivos de imagen, audio y video pueden ser un desafío.

En general, las organizaciones usan el sistema de administración de contenido (CMS) para administrar archivos binarios. Hay varias opciones disponibles en el mercado, desde código abierto hasta catering propietario, desde una pequeña organización hasta Fortune 10.

Autor: El Manifiesto Ágil en inglés

Blog: Agile, Scrum, Kanban, Arquitectura de soluciones

Twitter: @tjain

eso está relacionado principalmente con el proceso de mantenimiento y no importa si lo almacena con git o svn o incluso un servidor ftp.

para mi recomendación, sugiero usar Wiki.