Guía de Uso para el Lector

¿Cómo se presenta?

Los contenidos de MADEJA se clasifican en distintas secciones principales que se denominan subsistemas. En el siguiente gráfico se muestran los subsistemas en que se divide.

Cada subsistema contiene a su vez un conjunto de secciones denominadas áreas, y éstas a su vez incluyen lo que se llaman pautas, procedimientos y recursos.

Veremos a continuación en detalle cada uno de estos tipos de información.

SUBSISTEMAS

Los subsistemas son, como hemos comentado, los elementos principales en los que se estructura la información de MADEJA. Cada uno de ellos tiene claramente definidos los objetivos en los que está enfocado. Los subsistemas actualmente definidos, de acuerdo al gráfico anterior, son:

• Arquitectura
• Catálogo
• Desarrollo
• Interfaz de usuario
• Entorno
• Ingeniería
• Verificación

Todos los subsistemas tienen la misma estructura, con el objetivo de facilitar su lectura:

• Texto descriptivo del subsistema, donde se describen sus objetivos y se incluye un índice de contenidos
• Áreas: si en un subsistema se tratan distintos aspectos de cierta envergadura, cada uno de ellos se agrupa en un tipo de contenido denominado área. El índice de contenidos de un subsistema por tanto son enlaces directos a cada una de las áreas en las que un subsistema se haya dividido.

AREAS

Un área constituye una sección concreta dentro de un subsistema que trata contenido específico sobre una materia determinada. Todas las áreas disponen de una introducción que orienta sobre el tipo de contenidos que incluye. Las áreas pueden seguir una estructura anidada, de forma que dentro de un área se muestre el conjunto de sub-áreas en las que se divide. O bien un área puede ser de último nivel, en cuyo caso mostrará, mediante presentación tabular, los siguientes tipos de contenidos:

• Pestaña de PAUTAS
• Pestaña de PROCEDIMIENTOS
• Pestaña de RECURSOS

PAUTAS

Las pautas son el elemento más importante de MADEJA. Marcan cada uno de los aspectos que MADEJA considera relevantes en una determinada área, estableciendo los enunciados, mediante mensajes claros, concisos y verificables, en forma de directrices o consejos que se deben o recomiendan aplicar sobre las materias que se describen.

Las pautas se clasifican según su tipo en:

• Directrices. Conjunto de instrucciones o normas generales para la ejecución de alguna cosa. En MADEJA una directriz se encarga de fijar, de entre todas las posibilidades, la forma preferida de hacer algo. Las directrices tienen definido un carácter que puede tomar uno de los siguientes valores:
  • Obligatorias: Una directriz obligatoria es aplicable, cuando tenga sentido, sobre cualquier desarrollo realizado para la Junta de Andalucía.
  • Recomendadas: Cuando una directriz es opcional, la decisión de si aplica o no corresponderá a los responsables del desarrollo.
• Consejos. Recomendaciones sobre una materia cuyo fin es facilitar la toma de decisiones. Por definición, un consejo nunca puede tener carácter obligatorio, por lo que no será necesario clasificarlo como tal en este sentido.

Consideraciones: Una directriz recomendada puede acabar convirtiéndose en obligatoria si se considera así se favorece la consecución de los objetivos generales de MADEJA. Un consejo se diferencia de una directriz en que, mientras los consejos dan pistas que faciliten al responsable de la toma de decisiones elegir la opción que más le interesa, la directriz ya selecciona la opción, de entre las posibles.

Libro de pautas: Existen ocasiones en las que algunas pautas dentro de un área se utilizan para agrupar internamente a su vez un conjunto de pautas más simples, debido a su estrecha interrelación, o bien a consideraciones que haya que hacer para aplicarlas, como la necesidad de distinguir distintos matices, escenarios de aplicación, etc. Esta agrupación que permite estructurar mejor las pautas y dotarlas de un contexto completo es lo que se conoce como “libro de pautas”. En esos casos las pautas se redactan internamente con la misma estructura, pero creando apartados para cada una de las subpautas y una tabla resumen que explique qué se debe aplicar en cada caso.

PROCEDIMIENTOS

Un procedimiento es la formalización y documentación de un proceso sistemático que, mediante la ejecución de una secuencia de actividades o fases claramente definidos y repetibles, persigue la obtención de un resultado.

Los procedimientos que se incluyen dentro de un área son aquellos que se circunscriben, por la temática que tratan, dentro del mismo ámbito sobre el que versa el área.

Los procedimientos de MADEJA no se deben entender como secuencia de fases a nivel puramente técnico, sino que se trata de flujos de trabajo a nivel organizativo, con participación de usuarios con determinados roles dentro de la organización.

La definición de un procedimiento se caracteriza fundamentalmente por:

• Un gráfico o diagrama de flujo de actividades. Representación visual del procedimiento en forma de orden de ejecución y relaciones de dependencia entre actividades y puntos de decisión, haciendo referencia a los roles que deben ejecutar cada uno.
• Descripción detallada de cada una de las actividades que componen el procedimiento (tareas, responsables, productos...)

Cada uno de los procedimientos tiene definido un carácter, que puede tomar uno de los siguientes valores:

• obligatorio
• recomendado

RECURSOS

Un recurso es un concepto amplio dentro del ámbito de MADEJA. Los recursos proporcionan información a detalle, de bajo nivel de abstracción, que es necesario o recomendable conocer para la aplicación de las pautas y procedimientos. Es decir, los recursos se deben considerar como contenidos de soporte o ayuda para la aplicación o alineamiento con las pautas y procedimientos.

Los recursos aparecen agrupados en una tabla de recursos dependiente de un área específica. Aunque un recurso tiene entidad por sí mismo, normalmente los recursos toman su sentido y función dentro de MADEJA cuando van relacionados con las pautas y procedimientos. Por tanto, una pauta o procedimiento debe definir, de entre todos los recursos definidos dentro de un área, cuáles son aquellos con los que tiene relación directa, guiando de esta forma la lectura o navegación a través de los recursos. No obstante lo anterior, en la tabla de recursos de un área aparecerán listados todos los recursos relativos a dicha área, independientemente de la relación entre contenidos y su dependencia. De esta manera se muestra también una visión conjunta del contenido de MADEJA en lo relativo a un tema, y no obliga al usuario a tener que navegar por las páginas de contenido para descubrir nuevas piezas de información.

Los recursos se clasifican en tipos. Así, existen recursos de tipo "Herramienta", "Manual", "Ficha", "Legislación", "Ejemplo", etc. Para saber más sobre la finalidad y uso de los tipos de recursos, ir a la guía del redactor, apartado "Tipos de recursos".