31 enero, 2010

Técnica de Seudolenguaje usado en desarrollo de software y sus ventajas en la redacción de Procedimientos y afines

Definición Estilo de redacción para expresar instrucciones que combina el lenguaje natural con órdenes de control estructuradas.

Ventajas En general permite textos más concisos y claros. En el ejemplo que mostramos al final, se muestra como la cantidad de palabras se redujo en más del 36%. Hemos visto casos con niveles de reducción mayores aún pues al buscar redactar en seudolenguaje se ponen en evidencia los textos irrelevantes.

Las ventajas específicas son:

- Mayor facilidad para leer y entender los procedimientos.

- Mayor productividad de quien elabora la documentación del procedimiento.

- Reduce la necesidad de documentistas con buen estilo de redacción.

- Reduce los costos de actualización de la documentación.

- Reduce los costos de impresión y en consecuencia de energía.

Estándar Lo que sigue es el estándar que empleamos en M+S. Incluye prescripciones de fondo, propias de un seudolenguaje, con otras relativas al estilo o forma. Esta combinación propicia que personas distintas puedan llegar a un texto similar si tomaran el mismo encargo de redactar un procedimiento dado. Con ello se depende menos de preferencias y estilos personales.

- Desdoblar las Actividades de modo que tengan un claro y en único responsable (persona ó unidad organizativa).

- Numerar las Actividades de manera consecutiva: 1.0, 2.0, 3.0 etc.

- Empezar la frase de las Actividades con verbos en infinitivo (“ar”, “er”, ir”).

- Subrayar las palabras “En caso de:“, “En caso contrario:”; cuando se emplean para expresar excepciones y bifurcaciones. No emplear otros términos para estas situaciones.

- Usar Arial 10 para el texto normal.

- Poner en negrita los códigos y nombres de los documentos citados (procedimientos, formatos, instructivos).

- Poner en negrita el plazo máximo para aquellas Actividades que necesitan dicha definición.

- Justificar los textos hacia la izquierda.

Ejemplo

Este es un caso real donde se podrá notar que el estilo libre de redacción propicia redundancias y dificultad para identificar el flujo de trabajo, entre otras desventajas. Notar que no se requiere conocer lo que se está tratando para convertir un texto a seudolenguaje pues basta el análisis de la lógica del texto. Esto permite que puedan apoyar en la redacción personas no especializadas.

Antes:

Después:

Para solicitar mayor información, de click aquí: info@metodologias.net