Articles of documentation de

Nivel de detalle para usar en los comentarios de revisión de control de versión

Esto siempre me ha molestado por mucho time. Los comentarios que quedan en las revisiones son extremadamente útiles cuando vuelvo a ellos meses después; sin embargo, cuando son demasiado detallados, restan valor al objective general. Eventualmente me decidí por un sistema simple, en el que con cada comentario agrego algunas viñetas con una label en […]

UML en sistemas de control de revisiones

Entiendo la documentation del proyecto como parte de la evolución de un proyecto de software, a veces vinculado con el código (especialmente en metodologías lean). Es por eso que creo que sería una buena idea mantenerlo junto con el código en el sistema de control de revisiones (como git, en mi caso). Markdown parece ser […]

Documentación en un sistema de control de versiones

Ya he visto esta pregunta: Documentación y control de versiones Ahora la pregunta es, ¿qué tipo de documentation es adecuada para el control de versiones? Pienso en la documentation interna y de usuario. Esta documentation podría generarse, pero también podría ser files de text sin formatting, aunque esta es la última opción. El problema es […]

Cómo indexar y search el repository de CVS

En mi empresa, utilizamos CVS para almacenar todo tipo de files, desde el código fuente hasta los files de la oficina con documentation de requisitos, presentaciones, etc. Básicamente todo lo que es un file termina en el repository de CVS. Soy consciente de que esta no es una buena práctica. De todos modos, mi pregunta […]

¿Cómo implementar el control de versiones en Firebase?

Actualmente estoy usando Firebase como una herramienta de creación de prototypes para mostrar un layout frontal para una herramienta de documentation . En el process, nos ha gustado mucho el poder en time real de Firebase, y estamos explorando el potencial para usarlo en nuestra instancia de producción de una versión de código abierto / […]

¿Dónde poner qué al usar CVS, Wiki, gestión documental?

En nuestra compañía, actualmente estamos usando CVS para documentos de proyectos, informes de estado, etc., carpetas compartidas para documentation de installables / productos, etc. y algunos equipos usan Wiki (¿no sé para qué?). Ahora, estoy confundido en cuanto a dónde poner qué. Sería genial si pudieras describir qué herramientas usas en tu configuration y con […]

Estructura y herramientas para una gran aplicación java

¿Cuál es la mejor "forma" de crear una aplicación web java relativamente grande? Estoy pensando en eclipse como IDE, pero los sistemas de control de versiones, las herramientas de compilation y la documentation junto con el seguimiento de problemas y esas cosas. Github? Se pretende que sea un proyecto de "un solo hombre", pero quiero […]

¿Cómo lidiar con la versión de la documentation del software y el software en sí?

Necesito algunas experiencias relacionadas con la networkingacción de documentaciones de software y guías de usuario. Cuando escribo documentos formales como especificaciones de software, cada documento obtiene un número de versión y en el documento hay un historial de cambios después de la tabla de contenido, donde puede realizar un seguimiento de los cambios realizados en […]

Team Foundation Server – Una guía de progtwigdor

Además de mi tema anterior en Cómo usar SVN, Branch? ¿Etiqueta? ¿El maletero? Me gustaría profundizar en cómo un progtwigdor debería / podría usar TFS. Lo que más me interesa no es cómo configurar el server sino cómo lo usa a diario. En el área de la ingeniería de software, donde su responsabilidad no recae […]

¿Cómo mantener el código y las especificaciones sincronizados? – hay buenas herramientas

En mi equipo tenemos un gran sistema de control de fuente y tenemos excelentes especificaciones. El problema que me gustaría resolver es cómo mantener las especificaciones actualizadas con el código. Con el time, las especificaciones tienden a envejecer y quedar desactualizadas Las personas que hacen las especificaciones tienden a disgustar el control de la fuente […]