¿Se puede utilizar Google Docs para la documentación técnica del producto?

Mi empresa está contratando a un redactor técnico por contrato para mejorar la documentación de nuestro producto. Como mantenedor, actualmente uso Google Docs y estoy muy contento con su naturaleza colaborativa (múltiples editores simultáneos, basado en la web, sistema de comentarios/respuestas), facilidad de uso y capacidad para producir documentos PDF.

El recurso de redacción técnica necesita crear/aplicar estilos estándar a nuestros diversos documentos, volver a trabajar/reducir gran parte del contenido (somos ingenieros de software, no escritores), agregar tablas de contenido e índices y permitir la salida a HTML compatible con la web (mientras que aún permitiéndonos producir PDF). Por "amigable con la web", me refiero al contenido estándar a la derecha con la navegación a la izquierda.

¿Se puede lograr todo esto usando Google Docs? ¿Cuáles son las alternativas? Me preocupa cambiar a algo que no esté basado en la nube o me encierre en un binario propietario que solo se ejecuta en Windows u OSX.

Respuestas (1)

Google Docs es bastante limitado en su conjunto de funciones de procesamiento de texto. Tiene un conjunto muy básico de estilos que se pueden aplicar al texto. Por lo que puedo ver, no hay forma de cambiar la lista de estilos, aunque puede personalizar cómo aparecen.

Permite exportar a .doc, .pdf y varios otros formatos y tiene una función de "publicación en la web" que puede ver en acción aquí . Probablemente esto no sea lo que desea, por lo que también hay una exportación a html que presumiblemente le permite alojar el documento en otro lugar.

No parece haber ningún control sobre cómo aparece la navegación en la versión de publicación en la web. Publicar en la web y publicar en papel son tareas bastante diferentes y Gdocs parece estar diseñado con un modelo de papel primero.

Los Gdocs están bien para la edición básica de documentos y la edición colaborativa de documentos, pero carecen de muchas funciones importantes para usuarios avanzados. Sospecho que te decepcionará. Sin embargo, es posible exportar sus datos de gdocs a alguna otra herramienta, especialmente si tiene programadores disponibles para manipular la salida.

En cuanto a que esté basado en la nube: voy a sugerir que ya tiene una "nube" donde puede almacenar sus documentos: su sistema de control de versiones.

Además, Gdocs actualmente no genera tablas de contenido o líneas de índice.
Secundado en volver a usar su sistema de control de versiones. Esto también significa que cuando bifurca o etiqueta el código para lanzamientos, parches u otros esfuerzos específicos, sus documentos irán junto con el código, lo que ayudará a mantener claro qué va con qué.
@MετάEd Puede generar una tabla de contenido a partir de estilos de encabezado. Ver mi documento de ejemplo.
@MonicaCellio Iba a escribir eso en la respuesta, pero lo corté después de que amenazó con convertirse en un ensayo :)
@Mr.ShinyandNew安宇 sí, sería alejarse un poco de la pregunta, de ahí mi decisión de comentar, no sugerir una edición. :-)
No estoy seguro de que OP se sienta decepcionado por la falta de funciones avanzadas; ya está muy contento con él. Además, el problema con el VCS bien puede estar relacionado con la dificultad del redactor técnico del contrato para usarlo.
¿Se puede utilizar Google Docs para la documentación técnica del producto?
RespuestasAquíPolítica de privacidad1y, 0v