Tecnicas del sistema de docuemntación
Páginas: 8 (1994 palabras)
Publicado: 13 de abril de 2010
DOCUMENTACIÓN DEL SISTEMA
La documentación de sistemas es el conjunto de información que nos dice qué hacen los sistemas, cómo lo hacen y para quién lo hacen. La documentación consiste en material que explica las características técnicas y la operación de un sistema. Es esencial para proporcionar entendimiento de un sistema a quien lo vaya a usar para mantenerlo, para permitir auditoría delsistema y para enseñar a los usuarios como interactuar con el sistema y a los operandos como hacerlo funcionar. Existen varios tipos de documentación. La de programas, que explica la lógica de un programa e incluye descripciones, diagramas de flujo, listados de programas y otros documentos; la del usuarios en forma general la naturaleza y capacidades del sistema y cómo usarlo.
IMPORTANCIA DE LADOCUMENTACIÓN DE SISTEMAS
La documentación es esencial para proporcionar entendimiento de un sistema a quien lo vaya a usar para mantenerlo, para permitir auditorías del mismo y para enseñar a los usuarios como interactuar con él y a los operadores y administradores como hacerlo funcionar.
La documentación tiene una gran importancia dentro de una empresa, ya que esta ayuda a eliminar laposible dependencia que se pueda formar entre el proyecto realizado, y el ejecutor de éste. Para que toda aplicación tecnológica y todo servicio informático quede adecuadamente documentado, es necesario exigirle a quien lo diseñe y/o desarrolle (puede ser personal interno o un proveedor) que entregue dicha documentación obtenida a través del desarrollo del proyecto, de manera que otras personasrelacionadas o autorizadas por la empresa accedan a los conocimientos necesarios para corregir errores, hacer ajustes, etc. La oposición que entregan los técnicos a la realización del proceso de documentación, se basa principalmente en los costos en que se incurre para su construcción y en el mayor plazo de entrega. Pero estas justificaciones no son posibles de sustentar en la realidad, ya que elmayor costo en que se incurre para documentar se recupera con creces en el futuro, especialmente cuando se ve enfrentado a un error del sistema o tener que efectuarle mantenciones.
CARACTERÍSTICAS DE LA DOCUMENTACIÓN DE SISTEMAS
Pertinencia: los documentos que se proporcionan deben responder a las necesidades específicas de los utilizadores.
Exhaustividad: deben proporcionarse al usuariotodos los documentos que respondan a sus necesidades.
Rapidez: los documentos pertinentes deben transmitirse al usuario interesado inmediatamente después de su publicación.
Economía: el coste de la Documentación debe ser mínimo.
TIPOS DE DOCUMENTACIÓN
Documentación Manual
Este tipo de documentación se efectúa manualmente. Puede documentarse en papel o en algún medio magnético comodisquete o CD. Se cuenta con apoyo de sw para su confección, como un procesador de texto, planilla electrónica y programas graficadores.
Documentación Automática
Para este tipo de documentación, existen software que documentan. Pero estos software no están disponibles para todas las plataformas, por lo que hay que revisar bien el ambiente en que se trabaja para ver si existe algún software dedocumentación compatible. Este tipo de documentación es muy útil para:
Cubicar o dimensionar (definir plazo y costo) de trabajos de mantención de sw. Su utilización requiere de que el sw a analizar haya sido desarrollado en base a alguna norma y que esta norma haya sido respetada.
Apoyar labores de auditoría y control.
Los dos tipos de documentación no son incompatibles entre sí, por lo que sepuede lograr un equilibrio entre ambas para lograr una buena documentación a un buen costo.
QUÉ DOCUMENTAR
Existen elementos que son necesarios de mantener documentados, como los Manuales pueden estar en cualquier medio, ya sea en papel, CD, diskette, etc. Existen varios tipos de manuales, como:
Manual de Usuario: Este manual explica a los usuarios o clientes, como es la utilización del...
La documentación de sistemas es el conjunto de información que nos dice qué hacen los sistemas, cómo lo hacen y para quién lo hacen. La documentación consiste en material que explica las características técnicas y la operación de un sistema. Es esencial para proporcionar entendimiento de un sistema a quien lo vaya a usar para mantenerlo, para permitir auditoría delsistema y para enseñar a los usuarios como interactuar con el sistema y a los operandos como hacerlo funcionar. Existen varios tipos de documentación. La de programas, que explica la lógica de un programa e incluye descripciones, diagramas de flujo, listados de programas y otros documentos; la del usuarios en forma general la naturaleza y capacidades del sistema y cómo usarlo.
IMPORTANCIA DE LADOCUMENTACIÓN DE SISTEMAS
La documentación es esencial para proporcionar entendimiento de un sistema a quien lo vaya a usar para mantenerlo, para permitir auditorías del mismo y para enseñar a los usuarios como interactuar con él y a los operadores y administradores como hacerlo funcionar.
La documentación tiene una gran importancia dentro de una empresa, ya que esta ayuda a eliminar laposible dependencia que se pueda formar entre el proyecto realizado, y el ejecutor de éste. Para que toda aplicación tecnológica y todo servicio informático quede adecuadamente documentado, es necesario exigirle a quien lo diseñe y/o desarrolle (puede ser personal interno o un proveedor) que entregue dicha documentación obtenida a través del desarrollo del proyecto, de manera que otras personasrelacionadas o autorizadas por la empresa accedan a los conocimientos necesarios para corregir errores, hacer ajustes, etc. La oposición que entregan los técnicos a la realización del proceso de documentación, se basa principalmente en los costos en que se incurre para su construcción y en el mayor plazo de entrega. Pero estas justificaciones no son posibles de sustentar en la realidad, ya que elmayor costo en que se incurre para documentar se recupera con creces en el futuro, especialmente cuando se ve enfrentado a un error del sistema o tener que efectuarle mantenciones.
CARACTERÍSTICAS DE LA DOCUMENTACIÓN DE SISTEMAS
Pertinencia: los documentos que se proporcionan deben responder a las necesidades específicas de los utilizadores.
Exhaustividad: deben proporcionarse al usuariotodos los documentos que respondan a sus necesidades.
Rapidez: los documentos pertinentes deben transmitirse al usuario interesado inmediatamente después de su publicación.
Economía: el coste de la Documentación debe ser mínimo.
TIPOS DE DOCUMENTACIÓN
Documentación Manual
Este tipo de documentación se efectúa manualmente. Puede documentarse en papel o en algún medio magnético comodisquete o CD. Se cuenta con apoyo de sw para su confección, como un procesador de texto, planilla electrónica y programas graficadores.
Documentación Automática
Para este tipo de documentación, existen software que documentan. Pero estos software no están disponibles para todas las plataformas, por lo que hay que revisar bien el ambiente en que se trabaja para ver si existe algún software dedocumentación compatible. Este tipo de documentación es muy útil para:
Cubicar o dimensionar (definir plazo y costo) de trabajos de mantención de sw. Su utilización requiere de que el sw a analizar haya sido desarrollado en base a alguna norma y que esta norma haya sido respetada.
Apoyar labores de auditoría y control.
Los dos tipos de documentación no son incompatibles entre sí, por lo que sepuede lograr un equilibrio entre ambas para lograr una buena documentación a un buen costo.
QUÉ DOCUMENTAR
Existen elementos que son necesarios de mantener documentados, como los Manuales pueden estar en cualquier medio, ya sea en papel, CD, diskette, etc. Existen varios tipos de manuales, como:
Manual de Usuario: Este manual explica a los usuarios o clientes, como es la utilización del...
Leer documento completo
Regístrate para leer el documento completo.