¿Qué herramienta/formato utiliza para escribir sus especificaciones?[cerrado]

Question

Me gustaría saber qué tipo de herramienta utiliza para escribir sus especificaciones.Creo que es esencial utilizar una herramienta que admita algún tipo de formato de texto plano para poder controlar la especificación con un sistema de control de fuente como SVN.Tanto para la especificación como para el código, es importante tener un historial de todos los cambios.

Actualmente escribimos nuestra especificación en formato XML.TeX también sería una alternativa, pero es difícil para las personas que nunca han trabajado con él.

Déjame saber qué tipo de herramientas o formatos utilizas para las especificaciones.

Answer 1

DocBook editado con XXE, traducido a pdf con xslt cuando es necesario para enviarlo a los clientes.

El mejor cambio jamás realizado, mucho más fácil de escribir, mucho más fácil de fusionar y, cuando se convierte, no parece tan poco profesional como MSWord.

Además, el estilo del documento estructurado ya está ahí, a diferencia de las malditas palabras con las que tienes que luchar para empezar a trabajar.

Answer 2

Usamos TeX (MikTeX) y fue perfecto porque:

• texto sin formato - editar en Vim/Bloc de notas - en todas partes
• formato potente utilizando macros predefinidas que uno de nosotros hizo
• generación al hacer clic en PDF

El único problema fue conseguir diagramas (de ArgoUML).

En otro proyecto vi usar plantillas de Word: cosas horribles dirigidas desde arriba.

Consideraría usar algo como wiki/foro en la intranet.Imagínese usar GoogleDocs: hay versiones, está en línea...pero no aplicable para desarrollo comercial.

Answer 3

En el trabajo, muchos de nuestros documentos van bajo Sharepoint o algún otro sistema de documentos que realmente ralentiza la "publicación" de un documento.Esto significa que hay copias de los documentos por todas partes y conseguir que alguien publique algo correctamente es un dolor de cabeza.Debido a esto, normalmente recibía las especificaciones en power point o en papel de desecho.Así que puse una wiki (Media Wiki) en el trabajo en la que ahora guardamos todas las especificaciones del proyecto.Esto permite que cualquier persona de la empresa pueda verlos y nuestro grupo de desarrollo los pueda editar.A veces, un desarrollador le pide una aclaración al jefe cuando pasa o lo que sea y el desarrollador puede actualizar las especificaciones por sí mismo, lo cual creo que es una gran ventaja.Además, cuando las personas actualizan una especificación con nueva información usando el historial, es muy fácil ver cuáles fueron los cambios más recientes, lo que significa que puedo ver lo que estaba sucediendo antes y lo que debe suceder ahora, lo cual creo que es una gran ventaja.

Todavía conservo una especificación que estaba garabateada en una hoja de cuaderno en mi pared como recordatorio.

Answer 4

he venido a usar Libro de documentos para todas esas cosas.Es fácil, flexible y generará html, tex (y por lo tanto pdf), etc.

Answer 5

Microsoft Word.Sé que no cumple con sus requisitos, pero en cada trabajo que he tenido he usado Microsoft Word para las especificaciones.Usted puede, y yo lo he hecho, poner documentos de Word en un sistema de control de fuente. Lo único que pierde es la capacidad de diferenciar entre documentos.Aunque recuerdo vagamente haber leído en alguna parte que existen herramientas de diferencias para Word que se pueden usar.

Answer 6

En el trabajo usamos un wiki porque es excelente para la colaboración, pero Microsoft Word funcionará.

De hecho, puedes diferenciar dos versiones diferentes de un documento de Word usando el propio Word: utiliza la función "seguir cambios" para mostrar las diferencias.(Si no me cree, intente diferenciar dos versiones de un documento de Word usando TortoiseSVN).

Para documentos largos, prefiero Word a la wiki porque es muy adecuado para editar documentos largos y la gente de negocios se siente más cómoda trabajando con documentos de Word.