Preguntas etiquetadas con documentation

Realmente disfruto el diseño del lenguaje de programación. A veces pienso que mis proyectos de idiomas y sus usuarios potenciales se beneficiarían de un documento completo de estándares. He examinado muchos estándares de lenguaje, desde el muy formal (C ++) hasta el bastante informal (ECMAScript), pero realmente no puedo entender …

16 programming-languages  documentation  standardization 

Estoy trabajando en un producto para un cliente que debe ser válido y adecuado para su propósito. Está construido en una pila LAMP (PHP / Cake), por lo que hay licencias GPL, MIT, PHP, APACHE: "TAL CUAL", SIN GARANTÍAS O CONDICIONES DE NINGÚN TIPO, expresas o implícitas, incluidas, entre otras, …

15 licensing  documentation  specifications 

Actualmente estoy trabajando con un profesor en mi universidad para desarrollar nuevos planes de estudio para los cursos de Ingeniería de Software y Diseño Capstone que se ofrecen en mi universidad. Hasta hace poco, ambos cursos usaban el modelo de cascada exclusivamente y, por lo tanto, los estudiantes pasaban la …

15 agile  scrum  documentation 

Cerrado. Esta pregunta está fuera de tema . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que sea sobre el tema de Software Engineering Stack Exchange. Cerrado hace 6 años . Estoy buscando software para organizar y mantener la documentación interna de los proyectos, las …

15 project-management  documentation  knowledge-management  knowledge-base 

Si JSON significa JavaScript Object Notation, entonces cuando dices JSON object, ¿no estás diciendo realmente "JavaScript Object Notation Object"? ¿Sería más correcto decir "cadena JSON"? ¿O sería más correcto simplemente decir JSON? (como en "Estos dos servicios pasan JSON entre ellos").

15 documentation  grammar  json 

Tengo algunas preguntas sobre cómo escribir una especificación y son: Cuando escribimos una especificación de software, bajo el tema "Definición de requisitos de usuario", ¿tenemos que especificar únicamente las "Funciones" y "Restricciones"? ¿La "interfaz de usuario" cae en "funciones" o "restricciones"? ¿Cuáles son las principales áreas clave (requisitos) en las …

15 documentation  requirements 

¿Cuánta documentación técnica (para futuros desarrolladores) es suficiente ? ¿Existe una relación entre las horas de codificación y las horas de documentación que sea apropiada? Papadimoulis argumenta que deberías producir la menor cantidad de documentación necesaria para facilitar la mayor comprensión, ¿Es una buena guía o hay cosas específicas que …

15 documentation 

Nuestra compañía está en proceso de convertir muchos procesos comerciales manuales (y el conocimiento institucional asociado) en un nuevo software empresarial. El proyecto está yendo realmente bien, pero a medida que avanzamos, está claro que existe mucha confusión con respecto a los términos y definiciones tanto en el lado comercial …

14 documentation  domain-driven-design 

Recientemente me topé con lo útiles que son los objetos inmutables y que, por ejemplo, si pasa elementos a un constructor y su clase debe ser inmutable, debe copiar estos elementos si no son inmutables. Esto requiere mucha verificación o conocimiento sobre mi proyecto, porque si tengo public A(B foo) …

14 java  documentation  immutability 

Cerrada . Esta pregunta está basada en la opinión . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que pueda ser respondida con hechos y citas editando esta publicación . Cerrado hace 4 años . Actualmente estoy aprendiendo Python que no era parte de mi …

14 learning  python  interview  documentation 

Cerrada . Esta pregunta necesita estar más centrada . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que se centre en un problema solo editando esta publicación . Cerrado hace 4 años . En una línea similar a la de ¿Cómo pueden tener éxito los …

14 documentation 

Estamos integrando un proceso de prueba en nuestro proceso SCRUM. Mi nuevo rol es escribir pruebas de aceptación de nuestras aplicaciones web para automatizarlas más adelante. He leído mucho acerca de cómo deben escribirse los casos de prueba, pero ninguno me dio consejos prácticos para escribir casos de prueba para …

14 testing  documentation  acceptance-testing 

Trabajo en una compañía de sistemas de control, donde el trabajo principal es SCADA y PLC , junto con otras cosas de sistemas de control. El desarrollo de software no es realmente algo que la compañía hace, aparte de pequeños detalles aquí y allá, hasta que se tomó la decisión …

14 programming-practices  documentation  coding-standards  standardization 

Actualmente estoy usando dos sistemas para escribir documentación de código (estoy usando C ++): La documentación sobre métodos y miembros de la clase se agrega al lado del código, utilizando el formato Doxygen. En un servidor, Doxygen se ejecuta en las fuentes para que la salida se pueda ver en …

13 documentation  documentation-generation  wiki 

Para dar más detalles, estoy interesado en saber qué piensa la gente que necesita implementar mientras aún es un proyecto de un solo hombre (control de la fuente del equipo, documentación, compilaciones, etc.) y qué cosas no es necesario hacer hasta ese punto cuando llegue la segunda persona en el …

13 project-management  version-control  development-process  documentation  builds