1

TCNICAS DE DOCUMENTACIN Y
ARCHIVO
Dr. Ing. CELEDONIO MENDEZ VALDIVIA
UNIVERSIDAD NACIONAL DE INGENIERA
1
Contenido
1.1 Conceptos fundamentales
1.2 Consideraciones de software y hardware
1.3 Factores de calidad y productividad
1.4 Tcnicas de Documentacin
1.5 Problemas y soluciones en la
administracin de software
1.1
CONCEPTOS
FUNDAMENTALES
Qu es el Softwae!
Es el conjunto de los
programas de cmputo,
procedimientos, reglas,
documentacin y datos
asociados que forman
parte de las operaciones
de un sistema de
computacin
Fuente: estndar 729 del IEEE
A"li#a#iones de Softwae
Software de Sistema
Software de Tiempo Real
Software de Negocios
Software de Ingeniera/Cientfico
Software Incrustrado
Software de PC
Software de IA
Aplicaciones Web
Pes"e#ti$a %ist&i#a del
desaollo de softwae
Dcada 50-60:
Software como un aadido.
Desarrollo artesanal, a medida.
Lenguajes de bajo nivel.
Dcada 60-70:
Software como producto.
Dcada lenguajes y compilacin.
Crisis del software.
2
Pes"e#ti$a %ist&i#a del
desaollo de softwae
Dcada 70-80:
Programacin estructurada.
Ingeniera del Software.
Primeros mtodos estructurados.
Dcada 80-90:
Nuevos paradigmas de programacin y de
produccin de programas:
OO
C/S
Pes"e#ti$a %ist&i#a del
desaollo de softwae
90s - actualidad:
Anlisis/Diseo OO.
Tecnologa CASE
Componentes y reutilizacin
Interoperabilidad (CORBA, .NET...)
Internet
ISw. distribuida
repositorios de componentes reutilizables
e-business; e-commerce
1.'
CONS(DE)AC(ONES DEL
*A)D+A)E , SOFT+A)E
Considea#iones del
%adwae - softwae
El software es un elemento del sistema que
es lgico, en lugar de fsico.
El software se desarrolla no se fabrica en
un sentido clsico.
La mayora del software se construye a
medida.
Se usa en forma integral (todo o nada)
Fa#toes de #alidad -
"odu#ti$idad
Basili y Zelkowitz definen cinco factores importantes
que inciden en la productividad del software:
Factores humanos: El tamao y la
experiencia de la organizacin de desarrollo.
Factores del problema: La complejidad del
problema que se debe resolver y el nmero de
cambios en las restricciones o los requisitos del
diseo.
Factores del proceso: Tcnicas del
anlisis y diseo qu se utilizan, lenguajes y
herramientas CASE y tcnicas de revisin.
Factores del producto: Fiabilidad y
rendimiento del sistema basado en computadora.
. Fa#toes de #alidad -
"odu#ti$idad
3
Factores del recurso: Disponibilidad de
herramientas CASE, y recursos (hardware y
software).
. Fa#toes de #alidad -
"odu#ti$idad
Fiable
Capacidad de ofrecer los mismos resultados
bajo las mismas condiciones.
Eficiente
Utilizacin ptima de los recursos de la
mquina.
Ati/utos de #alidad del softwae0
Robusto
No poseer un comportamiento catastrfico
ante situaciones excepcionales
(Tolerante a fallos).
Correcto
Se ajusta a las especificaciones dadas por el
usuario.
.Ati/utos de #alidad del softwae0
Portable
Capaz de integrarse en entornos distintos con el
mismo esfuerzo.
Adaptable (extensibilidad)
Modificar alguna funcin sin que afecte a sus
actividades.
.Ati/utos de #alidad del softwae0
Inteligible
Diseo claro, bien estructurado y documentado.
No Errneo
No exista diferencia entre los valores reales y
los calculados
Reutilizable (reusabilidad)
.Ati/utos de #alidad del softwae0
1.1
FACTO)ES DE CAL(DAD DEL
SOFT+A)E
4
Fa#toes "aa la #alidad del
softwae0
El objetivo primordial de la ingeniera del software
es:
Producir un sistema, aplicacin o producto
de alta calidad
Para lograr este objetivo, los
ingenieros de software
deben aplicar mtodos
efectivos junto con
herramientas modernas
dentro del contexto de un
proceso maduro de
desarrollo del software.
. Fa#toes "aa la #alidad del
softwae0
La calidad de un sistema, aplicacin o producto
es tan bueno como:
Los requisitos que describen el problema,
El diseo que modela la solucin
El cdigo que conduce a un programa
ejecutable, y
Las pruebas de los programas para detectar
errores.
. Fa#toes "aa la #alidad del
softwae0
Un buen ingeniero del software utiliza mediciones
que evalan la calidad del anlisis y los modelos
de diseo, el cdigo fuente y los casos de prueba
que se han creado al aplicar ingeniera del
software.
Para lograr esta evaluacin de la calidad, el
ingeniero debe utilizar medidas tcnicas que
evalan la calidad con objetividad, no con
subjetividad.
. Fa#toes "aa la #alidad del
softwae0
El gestor de proyectos tambin debe evaluar la
calidad objetivamente, y no subjetivamente.
A medida que el proyecto progresa el gestor del
proyecto tambin debe evaluar la calidad.
Las mtricas privadas recopiladas por ingenieros
del software se asimilan para proporcionar
resultados en los proyectos.
. Fa#toes "aa la #alidad del
softwae0
Aunque se pueden recopilar muchas medidas de
calidad, el primer objetivo en el proyecto es medir
errores y defectos.
Las mtricas que provienen de estas medidas
proporcionan una indicacin de la efectividad de
las actividades de control y de la garanta de
calidad del conjunto o de alguna de las partes
. Fa#toes "aa la #alidad del
softwae0
5
Los errores detectados por hora de revisin y los
errores detectados por hora de prueba proporcionan
una visin profunda de la eficacia de cada una de
las actividades implicadas en la mtrica.
.Fa#toes "aa la #alidad del softwae0
Visin general de los factores que afectan a la
calidad:
En las dos dcadas pasadas, McCall y Cavano
definieron un juego de factores de calidad como los
primeros pasos hacia el desarrollo de mtricas de
la calidad del software.
Estos factores evalan el software desde tres
puntos de vista distintos:
.Fa#toes "aa la #alidad del softwae0
Operacin del producto (utilizndolo).
Revisin del producto (cambindolo).
Transicin del producto (modificndolo para
que funcione en un entorno diferente, por
ejemplo portndolo.
La relacin entre estos factores de calidad es lo
que se llama un marco de trabajo.
. Fa#toes "aa la #alidad del
softwae0
El marco de trabajo proporciona un mecanismo para
que el gestor del proyecto identifique lo que
considera importante.
Estas cualidades son atributos del software, adems
de su correccin y rendimiento funcional, que tiene
implicaciones en el ciclo de vida.
En otros factores, como son facilidad de
mantenimiento y portabilidad, se ha demostrado que
tienen un impacto significativo en el costo del ciclo
de vida...
Fa#toes de #alidad del softwae
MA)CO DE T)A2A3O
En segundo lugar, el marco
de trabajo proporciona un
medio de evaluar
cuantitativamente lo bien
que va progresando el
desarrollo en relacin con
los objetivos de calidad
establecidos.
Fa#toes de #alidad del softwae
MA)CO DE T)A2A3O
En tercer lugar, el marco de trabajo proporciona
ms interaccin del personal de calidad en el
esfuerzo de desarrollo.
Fa#toes de #alidad del softwae
MA)CO DE T)A2A3O
6
Por ltimo, el personal de garanta de calidad
puede utilizar indicaciones de calidad pobre
para ayudar a identificar estndares
[mejores] a contrastar en el futuro.
Fa#toes "aa la #alidad del
softwae0
Aunque hay muchas medidas
de la calidad de software, la
correccin, facilidad de
mantenimiento integral y
facilidad de uso proporcionan
indicadores tiles para el
equipo del proyecto.
Gilb sugiere definiciones y
medidas para cada uno de
ellos.
Fa#toes "aa la #alidad del softwae
Medida de la #alidad0
Correccin:
Un programa debe operar
correctamente o
proporcionar poco valor a
sus usuarios.
La correccin es el grado en
el que el software lleva a
cabo su funcin requerida.
Fa#toes "aa la #alidad del
softwae0
Facilidad de mantenimiento:
El mantenimiento del software cuenta con ms
esfuerzo que cualquier otra actividad de ingeniera
del software.
La facilidad de mantenimiento es la facilidad con la
que se puede corregir un programa si se encuentra
un error, se puede adaptar si su entorno cambia, o
mejorar si el cliente desea un cambio de requisitos.
Fa#toes "aa la #alidad del
softwae0
No hay forma de medir
directamente la facilidad
de mantenimiento; por
consiguiente, se deben
utilizar medidas indirectas.
Fa#toes "aa la #alidad del
softwae0
Integridad:
En esta poca de intrusos informticos y de virus,
la integridad del software ha llegado a tener mucha
importancia.
Este atributo mide la habilidad de un sistema para
resistir ataques (tanto accidentales como
intencionados) contra su seguridad.
El ataque se puede realizar en cualquiera de los
tres componentes del software: programas, datos y
documentos.
Fa#toes "aa la #alidad del softwae0
7
Para medir la integridad, se tienen que definir dos
atributos adicionales: amenaza y seguridad.
Amenaza es la probabilidad (que se puede estimar
o deducir de la evidencia emprica) de que un
ataque de un tipo determinado ocurra en un tiempo
determinado.
La seguridad es la probabilidad (que se puede
estimar o deducir de la evidencia emprica) de que
se pueda repeler el ataque de un tipo determinado.
Fa#toes "aa la #alidad del softwae0
Facilidad de uso:
El calificativo amigable con el usuario se ha
convertido en omnipresente en las discusiones
sobre productos de software.
Si un programa no es amigable con el usuario,
frecuentemente est destinado al fracaso, aunque
las funciones que realice sean valiosas.
La facilidad de uso es un intento de cuantificar lo
amigable que puede ser con el usuario
Fa#toes "aa la #alidad del softwae0
1.4
DOCUMENTAC(5N DEL
SOFT+A)E
Do#u6enta#i&n de
softwae
Recomendaciones para documentar
Ejemplos de documentacin
Recomendaciones para documentacin de
capacitacin
En #uanto al Contenido
Desde los procesos
Definir los procesos, las actividades y las tareas.
Elaborar diagramas
Explicacin del funcionamiento del software
)e#o6enda#iones
es"e#to al (dio6a
Escribir en tercera persona
Siempre debe estar identificado quin realiza
la accin, por ejemplo: el sistema, la opcin,
el mdulo, la pantalla, la ventana, el botn.
No utilizar gerundios
Verbos en presente
No utilizar muletillas (de que, cual, etc.)
8
Ca"a#ita#i&n
Idioma sencillo
Material complementario eficiente
Definir claramente el objetivo de la
capacitacin e identificar los logros a obtener
Ejercicios o parte prctica
*ea6ientas de a"o-o
Las herramientas de apoyo documental le
permiten asegurar la integridad de la
informacin.
Ayudas en lnea, demos, manuales impresos,
guas rpidas, entre otras
1.7
P)O2LEMAS , SOLUC(ONES
EN LA ADM(N(ST)AC(5N DE
SOFT+A)E
Po/le6as - solu#iones en la
ad6inista#i&n de softwae
Thayer, Pyster y Wood sugirieron 20 reas
potenciales, y pidieron a 294 personas su
opinin respecto a la importancia de los
problemas, la naturaleza de stos, ya fuera
tcnica, gerencial o ambas, y sobre su
posible solucin.
Po/le6as - solu#iones en la
ad6inista#i&n de softwae
problemas importantes en la administracin fueron:
La planeacin de proyectos de programacin es
generalmente pobre.
Los procedimientos y las tcnicas para la seleccin
de los gerentes de proyecto son pobres.
La contabilidad en proyectos de programacin es
pobre, cuestionando sobre quin es el responsable
de las diversas funciones del proyecto.
Po/le6as - solu#iones en la
ad6inista#i&n de softwae
La capacidad para estimar correctamente los
recursos requeridos para completar un proyecto
de programacin es pobre.
Los criterios de xito en el desarrollo de
proyectos son, con frecuencia, inapropiados;
esto repercute en productos de programacin no
confiables, difciles de usar y de mantener .
No existen reglas de decisin para ayudar a la
seleccin de la adecuada organizacin
estructural.
9
No existen reglas de decisin para ayudar a la
seleccin de las tcnicas gerenciales ms
correctas para los proyectos de programacin.
No siempre existen procedimientos, mtodos y
tcnicas para el diseo de un sistema de control
del proyecto que permita a los gerentes controlar
con xito sus proyectos.
Po/le6as - solu#iones en la
ad6inista#i&n de softwae
No siempre existen procedimientos, tcnicas,
estrategias y ayuda que permitan vigilar el
avance real de un proyecto.
No existen estndares y tcnicas para medir la
calidad del desempeo y la cantidad de
produccin esperada de los programadores y
analistas de procesamiento de datos.
Po/le6as - solu#iones en la
ad6inista#i&n de softwae