UNIVERSIDAD NACIONAL DE INGENIERA

1
TCNICAS DE DOCUMENTACIN Y
ARCHIVO

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

Ing. MSc. CELEDONIO MENDEZ VALDIVIA

Qu es el Software?

1.1
CONCEPTOS
FUNDAMENTALES

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

Aplicaciones de Software
Software de Sistema
Software de Tiempo Real
Software de Negocios
Software de Ingeniera/Cientfico
Software Incrustrado
Software de PC
Software de IA

Perspectiva histrica del

desarrollo de software
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.

Aplicaciones Web

Perspectiva histrica del

desarrollo de software
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

Perspectiva histrica del

desarrollo de software
90s - actualidad:
Anlisis/Diseo OO.
Tecnologa CASE
Componentes y reutilizacin
Interoperabilidad (CORBA, .NET...)
Internet
ISw. distribuida
repositorios de componentes reutilizables
e-business; e-commerce

Consideraciones del
hardware y software

1.2
CONSIDERACIONES DEL
HARDWARE Y SOFTWARE

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)

Factores de calidad y
productividad
Basili y Zelkowitz definen cinco factores importantes
que inciden en la productividad del software:

Factores humanos: El tamao y la

Factores de calidad y
productividad
Factores del proceso: Tcnicas del
anlisis y diseo qu se utilizan, lenguajes y
herramientas CASE y tcnicas de revisin.

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 producto: Fiabilidad y

rendimiento del sistema basado en computadora.

 Factores de calidad y
productividad
Factores del recurso: Disponibilidad de
herramientas CASE, y recursos (hardware y
software).

Atributos de calidad del software:

Fiable
Capacidad de ofrecer los mismos resultados
bajo las mismas condiciones.

Eficiente
Utilizacin ptima de los recursos de la
mquina.

Atributos de calidad del software:

Robusto
No poseer un comportamiento catastrfico
ante situaciones excepcionales
(Tolerante a fallos).

Correcto
Se ajusta a las especificaciones dadas por el
usuario.

Atributos de calidad del software:

Portable
Capaz de integrarse en entornos distintos con el
mismo esfuerzo.

Adaptable (extensibilidad)
Modificar alguna funcin sin que afecte a sus
actividades.

Atributos de calidad del software:

Inteligible

1.3

Diseo claro, bien estructurado y documentado.

No Errneo
No exista diferencia entre los valores reales y
los calculados

FACTORES DE CALIDAD DEL

SOFTWARE

Reutilizable (reusabilidad)

Factores para la calidad del

software:
El objetivo primordial de la ingeniera del software
es:

Producir un sistema, aplicacin o producto

de alta calidad

Factores para la calidad del

software:
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.

Factores para la calidad del

software:

Factores para la calidad del

software:

La calidad de un sistema, aplicacin o producto

es tan bueno como:

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.

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.

Factores para la calidad del

software:
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.

Para lograr esta evaluacin de la calidad, el

ingeniero debe utilizar medidas tcnicas que
evalan la calidad con objetividad, no con
subjetividad.

Factores para la calidad del

software:
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

Factores para la calidad del software:

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.

Factores para la calidad del software:

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:

Factores para la calidad del

software:
Operacin del producto (utilizndolo).

Factores de calidad del software

MARCO DE TRABAJO
El marco de trabajo proporciona un mecanismo para
que el gestor del proyecto identifique lo que
considera importante.

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.

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 transportabilidad, se ha demostrado
que tienen un impacto significativo en el costo del
ciclo de vida...

Factores de calidad del software

Factores de calidad del software

MARCO DE TRABAJO
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.

MARCO DE TRABAJO
En tercer lugar, el marco de trabajo proporciona
ms interaccin del personal de calidad en el
esfuerzo de desarrollo.

Factores para la calidad del

software:
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.

Factores para la calidad del software

Medida de la calidad:
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.

Factores para la calidad del

software:
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.

Factores para la calidad del

software:
No hay forma de medir
directamente la facilidad
de mantenimiento; por
consiguiente, se deben
utilizar medidas indirectas.

Factores para la calidad del

software:
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.

Factores para la calidad del software:

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.

Factores para la calidad del software:

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.

1.4

Factores para la calidad del software:

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 abocado al fracaso, incluso
aunque las funciones que realice sean valiosas.
La facilidad de uso es un intento de cuantificar lo
amigable que puede ser con el usuario

Documentacin de
software
Recomendaciones para documentar

DOCUMENTACIN DEL
SOFTWARE

Ejemplos de documentacin
Recomendaciones para documentacin de
capacitacin

En cuanto al Contenido
Desde los procesos
Definir los procesos, las actividades y las tareas.
Elaborar diagramas

Explicacin del funcionamiento del software

Recomendaciones
respecto al Idioma
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.)

Capacitacin
Idioma sencillo
Material complementario eficiente
Definir claramente el objetivo de la
capacitacin e identificar los logros a obtener
Ejercicios o parte prctica

1.5
PROBLEMAS Y SOLUCIONES
EN LA ADMINISTRACIN DE
SOFTWARE

Problemas y soluciones en la
administracin de software
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.

Herramientas de apoyo
Las herramientas de apoyo documental le
permiten asegurar la integridad de la
informacin.
Ayudas en lnea, demos, manuales impresos,
guas rpidas, entre otras

Problemas y soluciones en la
administracin de software
Thayer, Pyster y Wood sugirieron 20 reas
potenciales, y pidieron a 294 individuos su
opinin respecto a la importancia de los
problemas, la naturaleza de stos, ya fuera
tcnica, gerencial o ambas, y sobre su
posible solucin.

Problemas y soluciones en la
administracin de software
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.

Problemas y soluciones en la
administracin de software

Problemas y soluciones en la
administracin de software

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, tcnicas,

estrategias y ayuda que permitan vigilar el
avance real de un proyecto.

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.

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.