Diferencia entre revisiones de «The Library Search Engine: A Smart Solution for Integrating Resources Beyond Library Holdings»
| Línea 1: | Línea 1: | ||
==Introducción== | ==Introducción== | ||
| − | La documentación de un software es el registro de todo lo que ocurrió en la implementación de una solución. Existen distintas | + | La documentación de un [https://es.wikipedia.org/wiki/Software software] es el registro de todo lo que ocurrió en la implementación de una solución. Existen distintas |
metodologías sobre cómo hacer documentación. Aunque sí es importante estudiarlas, lo principal es evaluar qué funciona y qué no. | metodologías sobre cómo hacer documentación. Aunque sí es importante estudiarlas, lo principal es evaluar qué funciona y qué no. | ||
No es inteligente seguir ciegamente una metodología sólo porque así lo dice la certificación o el libro. Las circunstancias | No es inteligente seguir ciegamente una metodología sólo porque así lo dice la certificación o el libro. Las circunstancias | ||
| Línea 17: | Línea 17: | ||
|- | |- | ||
|Análisis del sistema de funciones del software | |Análisis del sistema de funciones del software | ||
| − | + | |Planificación plan del proyecto | |
| − | | | ||
|- | |- | ||
| − | | | + | |Análisis de requisitos o creación de un prototipo |
| − | + | |Especificación de requisitos | |
| − | | | ||
|- | |- | ||
| − | | | + | |Diseño de datos y arquitectónico |
| − | + | |Especificación preliminar del diseño | |
| − | | | ||
|- | |- | ||
| − | | | + | |Diseño procedimental |
| − | + | |Especificación detallada del diseño | |
| − | | | ||
|- | |- | ||
| − | | | + | |Codificación |
| − | + | |Documentación del código | |
| − | | | ||
|- | |- | ||
| − | | | + | |Pruebas |
| − | + | |Plan, procedimientos y resultados de las pruebas | |
| − | | | ||
|- | |- | ||
|Lanzamiento y distribución | |Lanzamiento y distribución | ||
| − | |||
|Documentación del usuario | |Documentación del usuario | ||
|- | |- | ||
|Mantenimiento | |Mantenimiento | ||
| − | |||
|Documentos modificados | |Documentos modificados | ||
|} | |} | ||
| Línea 61: | Línea 53: | ||
IV:Presupuesto –además del Documento no II: Planos, que es fundamental cuando se trata de construcciones, etc.-). | IV:Presupuesto –además del Documento no II: Planos, que es fundamental cuando se trata de construcciones, etc.-). | ||
| − | ==Relación entre las etapas de | + | ==Relación entre las etapas de proyecto y las etapas de su ejecución== |
Son muchas las diferencias entre proyectos informáticos y los de otras tecnologías, pero interesa aquí señalar una, que se | Son muchas las diferencias entre proyectos informáticos y los de otras tecnologías, pero interesa aquí señalar una, que se | ||
refiere a la relación y a la división y separación entre dos grandes etapas del proyecto y su ejecución; etapas que son las | refiere a la relación y a la división y separación entre dos grandes etapas del proyecto y su ejecución; etapas que son las | ||
| Línea 70: | Línea 62: | ||
==Interés de la estructura documental uniforme para los proyectos de diversas tecnologías== | ==Interés de la estructura documental uniforme para los proyectos de diversas tecnologías== | ||
La estructura documental señalada, se puede decir que encuentra su justificación en los siguientes aspectos, al menos: | La estructura documental señalada, se puede decir que encuentra su justificación en los siguientes aspectos, al menos: | ||
| + | |||
1. Tiene una correspondencia con los llamados “factores del proyecto”, esto es, con los objetivos, contenidos y las condiciones | 1. Tiene una correspondencia con los llamados “factores del proyecto”, esto es, con los objetivos, contenidos y las condiciones | ||
| − | que el proyecto debe considerar. | + | que el proyecto debe considerar. E. Gómez-Senent (1994), presenta un cuadro en el que se expresa gráficamente la relación entre cada uno de los cuatro documentos |
| − | E. Gómez-Senent (1994), presenta un cuadro en el que se expresa gráficamente la relación entre cada uno de los cuatro documentos | ||
típicos de cualquier proyecto tecnológico, y los que denomina factores del proyecto. Esto es, en todo proyecto tecnológico, | típicos de cualquier proyecto tecnológico, y los que denomina factores del proyecto. Esto es, en todo proyecto tecnológico, | ||
aparecen determinados objetivos, condiciones, contenidos, etc. (los factores) que son recogidos en cada uno de los documentos | aparecen determinados objetivos, condiciones, contenidos, etc. (los factores) que son recogidos en cada uno de los documentos | ||
referidos. | referidos. | ||
| + | |||
2. Aparece recogida en alguna normativa legal, relativa a ciertos tipos de Proyectos. | 2. Aparece recogida en alguna normativa legal, relativa a ciertos tipos de Proyectos. | ||
| + | |||
3. La recomienda el Instituto de Ingenieros Civiles de España. | 3. La recomienda el Instituto de Ingenieros Civiles de España. | ||
| + | |||
4. Está arraigada en la práctica de Proyectos anteriores a la Informática. Y mantiene su vigencia a pesar del paso del tiempo | 4. Está arraigada en la práctica de Proyectos anteriores a la Informática. Y mantiene su vigencia a pesar del paso del tiempo | ||
(incluso centenario), por lo que se trata de una estructura útil. | (incluso centenario), por lo que se trata de una estructura útil. | ||
| + | |||
5. Es la utilizada por las Administraciones Públicas, cuya participación en la actividad social es muy importante, tanto en | 5. Es la utilizada por las Administraciones Públicas, cuya participación en la actividad social es muy importante, tanto en | ||
España como en la Unión Europea (con esto se quiere indicar que la propuesta se formula también para los proyectos de promoción | España como en la Unión Europea (con esto se quiere indicar que la propuesta se formula también para los proyectos de promoción | ||
privada). | privada). | ||
| + | |||
6. Es conocida por muchas personas de las organizaciones públicas (y también, por supuesto, de las empresas), si estas han | 6. Es conocida por muchas personas de las organizaciones públicas (y también, por supuesto, de las empresas), si estas han | ||
encargado algún Proyecto de tecnologías. | encargado algún Proyecto de tecnologías. | ||
| + | |||
7. El profesional de las Tecnologías de la información puede trabajar en equipos interdisciplinares. Una razón para la | 7. El profesional de las Tecnologías de la información puede trabajar en equipos interdisciplinares. Una razón para la | ||
convergencia hacia la norma referida, es que estos profesionales no siempre trabajan individualmente o en grupos de personas de | convergencia hacia la norma referida, es que estos profesionales no siempre trabajan individualmente o en grupos de personas de | ||
| − | la misma profesión, sino que pueden hacerlo con frecuencia en el seno de equipos | + | la misma profesión, sino que pueden hacerlo con frecuencia en el seno de equipos interdisciplinares − formados por profesionales de otras tecnologías y especialidades, y otros titulados, etc.− y la estructura normalizada la conoce todo profesional. |
| − | interdisciplinares − formados por profesionales de otras tecnologías y especialidades, y otros titulados, etc.− y la estructura | + | |
| − | normalizada la conoce todo profesional. | ||
8. Ha demostrado ser operativa para buscar la información deseada en una documentación extensa (como suele ser la del Proyecto). | 8. Ha demostrado ser operativa para buscar la información deseada en una documentación extensa (como suele ser la del Proyecto). | ||
Revisión del 10:37 15 ene 2019
Sumario
- 1 Introducción
- 2 La estructura documental de los proyectos de desarrollo de software
- 3 Comparación de la documentación de proyectos de desarrollo de software con proyectos de otras tecnologías
- 4 Relación entre las etapas de proyecto y las etapas de su ejecución
- 5 Interés de la estructura documental uniforme para los proyectos de diversas tecnologías
- 6 Referencias
Introducción
La documentación de un software es el registro de todo lo que ocurrió en la implementación de una solución. Existen distintas metodologías sobre cómo hacer documentación. Aunque sí es importante estudiarlas, lo principal es evaluar qué funciona y qué no. No es inteligente seguir ciegamente una metodología sólo porque así lo dice la certificación o el libro. Las circunstancias nunca van a ser las mismas que las del autor de la metodología.
La estructura documental de los proyectos de desarrollo de software
La estructura documental de los proyectos de desarrollo de [software] suele consistir en un documento –o más de uno- por cada una de las fases del desarrollo, si se sigue la versión 2.1 de MÉTRICA (o por cada uno de los procesos del desarrollo, si se sigue la versión 3). Esta documentación es la que establecen los manuales de Ingeniería del Software, indicándose en el cuadro no. 1 la documentación que indica R. S. Pressman (1992).
| Pasos | Documento Generado |
|---|---|
| Análisis del sistema de funciones del software | Planificación plan del proyecto |
| Análisis de requisitos o creación de un prototipo | Especificación de requisitos |
| Diseño de datos y arquitectónico | Especificación preliminar del diseño |
| Diseño procedimental | Especificación detallada del diseño |
| Codificación | Documentación del código |
| Pruebas | Plan, procedimientos y resultados de las pruebas |
| Lanzamiento y distribución | Documentación del usuario |
| Mantenimiento | Documentos modificados |
Cuadro 1. La documentación técnica generada en cada paso de las fases del desarrollo y mantenimiento de software
Comparación de la documentación de proyectos de desarrollo de software con proyectos de otras tecnologías
Entendemos que la documentación que se presenta en los proyectos de software, se corresponde principalmente con la que aparece en Anexos a la Memoria en los proyectos que no son informáticos. Como se indica en el apartado 2, la Memoria es el Documento no I, y consta de dos partes principales que son: - I.1: Memoria, propiamente dicha - I.2: Anexos a la Memoria. La documentación que se presenta con los proyectos de desarrollo de software corresponde a la Documentación Técnica, que también se presenta en los no informáticos; pero en estos aparece, como se ha dicho, agrupada en los Anexos, que forman parte del documento no I (Memoria); y el resto de documentación se independiza, formando otros documentos (Documento no. III: Pliego de condiciones, y Documento no IV:Presupuesto –además del Documento no II: Planos, que es fundamental cuando se trata de construcciones, etc.-).
Relación entre las etapas de proyecto y las etapas de su ejecución
Son muchas las diferencias entre proyectos informáticos y los de otras tecnologías, pero interesa aquí señalar una, que se refiere a la relación y a la división y separación entre dos grandes etapas del proyecto y su ejecución; etapas que son las siguientes: - Etapa de Proyecto - Etapa de Ejecución del Proyecto
Interés de la estructura documental uniforme para los proyectos de diversas tecnologías
La estructura documental señalada, se puede decir que encuentra su justificación en los siguientes aspectos, al menos:
1. Tiene una correspondencia con los llamados “factores del proyecto”, esto es, con los objetivos, contenidos y las condiciones que el proyecto debe considerar. E. Gómez-Senent (1994), presenta un cuadro en el que se expresa gráficamente la relación entre cada uno de los cuatro documentos típicos de cualquier proyecto tecnológico, y los que denomina factores del proyecto. Esto es, en todo proyecto tecnológico, aparecen determinados objetivos, condiciones, contenidos, etc. (los factores) que son recogidos en cada uno de los documentos referidos.
2. Aparece recogida en alguna normativa legal, relativa a ciertos tipos de Proyectos.
3. La recomienda el Instituto de Ingenieros Civiles de España.
4. Está arraigada en la práctica de Proyectos anteriores a la Informática. Y mantiene su vigencia a pesar del paso del tiempo (incluso centenario), por lo que se trata de una estructura útil.
5. Es la utilizada por las Administraciones Públicas, cuya participación en la actividad social es muy importante, tanto en España como en la Unión Europea (con esto se quiere indicar que la propuesta se formula también para los proyectos de promoción privada).
6. Es conocida por muchas personas de las organizaciones públicas (y también, por supuesto, de las empresas), si estas han encargado algún Proyecto de tecnologías.
7. El profesional de las Tecnologías de la información puede trabajar en equipos interdisciplinares. Una razón para la convergencia hacia la norma referida, es que estos profesionales no siempre trabajan individualmente o en grupos de personas de la misma profesión, sino que pueden hacerlo con frecuencia en el seno de equipos interdisciplinares − formados por profesionales de otras tecnologías y especialidades, y otros titulados, etc.− y la estructura normalizada la conoce todo profesional.
8. Ha demostrado ser operativa para buscar la información deseada en una documentación extensa (como suele ser la del Proyecto).
Referencias
GÓMEZ-SENENT, E. y CHINER, M. (1.994): El Proceso Proyectual. Ed. Universidad Politécnica de Valencia, Valencia.
PRESSMAN, R. S. (1.992): Ingeniería de Software. Un enfoque práctico. Ed. McGraw-Hill, Madrid
Categorías: Sofware | Desarrollo de software
