|
|
Línea 1: |
Línea 1: |
− | | + | === fw0e`hf3 fhw`fhwe === |
− | ==Introducción==
| + | 4th0ir tjhrtuh`4t uh'`4uth rtuh'43 h4t¡t4r |
− | 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.
| |
− | 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).
| |
− | | |
− | {|
| |
− | ! style="text-align:left;"| 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]]
| |