Estoy a punto de empezar a escribir mucha documentación. Mientras escribo, me encuentro repitiendo cosas sobre las que ya he escrito en otras partes de la documentación. Por ejemplo, quiero escribir una guía de "Cómo empezar". Aquí, debe haber explicaciones básicas de las características principales de la interfaz. En otro documento quiero escribir sobre cómo colaborar de manera eficiente usando nuestras herramientas. En este documento también necesito las mismas explicaciones básicas de nuestras interfaces principales en caso de que el lector no las conozca todas. Me gustaría hacer esto incorporando un objeto de "explicación básica", que debería reutilizarse en ambos documentos para que cuando se actualice, ambos documentos se actualicen. Sé que podría hacer todo esto con enlaces,
¿Qué herramientas de edición colaborativa en línea pueden admitir dicha edición? Mi editor preferido es Google Docs, pero estoy abierto a todo. Google Docs no admite incrustaciones.
Atlassian's Confluence ofrece extractos , que es una función de transclusión basada en sus macros .
Hay un debate sobre cómo integrar Confluence con la herramienta en línea de Atlassian, Bitbucket. La herramienta Bitbucket proporciona una wiki que se puede utilizar con fines de documentación.
Zachary Vance
Zachary Vance
David