DOCUMENTACIÓN TÉCNICA. Sesión 7: Mapeo de información

Transcripción

1 DOCUMENTACIÓN TÉCNICA Sesión 7: Mapeo de información

2 Contextualización Mapeo de información Un elemento importante de la documentación técnica es colocar etiquetas a los bloques de información como un punto de identificación rápido en su consulta. Las etiquetas deben ser muy claras para dar una verdadera idea al lector acerca de lo que contiene el bloque.

3 Contextualización Mapeo de información Existen varios tipos de etiquetas según la función que desempeñen, así como una serie de reglas y recomendaciones para realizarlas. Enseguida se comentarán los tipos de etiquetas, los elementos para elaborarlas y algunos ejemplos al respecto.

4 Introducción Una idea clave del método Mapeo de Información consiste en comenzar a bosquejar bloques sin preocuparse al principio por etiquetar o escribir párrafos, es decir, identificar el tipo de bloque y sus características. Otra idea importante es etiquetar cada bloque (una vez desarrollado o bosquejado) para que el lector pueda identificar la estructura del documento...

5 Introducción Una etiqueta debe hacer que el propósito del bloque sea inmediatamente claro para el lector. Una etiqueta debe contestar a la pregunta: qué va a decir este bloque? Por qué crees que una etiqueta debe ser corta y concisa?

6 Explicación Etiquetas de bloques Los escritores deben crear etiquetas útiles para los bloques, a través de las siguientes reglas: 1. Escribir etiquetas que describan con precisión el contenido del bloque. 2. Conservar las etiquetas cortas y concisas. 3. Conservar un vocabulario consistente en la etiqueta y en el bloque.

7 Explicación Etiquetas de bloques 4. Usar palabras familiares para el lector, en lugar de la jerga o términos técnicos. Excepción: se puede usar un término técnico que los lectores lo entienden y prefieren porque es más adecuado y descriptivo que un término común. 5. Evitar etiquetas graciosas, tramposas o triviales.

8 Explicación Etiquetas de bloques 6. Conservar el lenguaje apropiado al significado real y a la importancia del bloque. Ejemplo: Comentario es una buena etiqueta para un bloque que contiene información opcional. Precaución o Importante recordar son buenas etiquetas para bloques que contienen información significativa.

9 Explicación Etiquetas de bloques 7. No usar frases de transición como Por otro lado o etiquetas seguidas de puntos suspensivos (...). Comentario: colocar la información secundaria o información sobre cómo se relacionan los bloques entre sí, en bloques como Visión general, Introducción, Antecedentes o Comentarios.

10 Explicación Etiquetas de bloques Una etiqueta específica del tema es un término, frase u oración que se deriva del tema de un bloque particular. Para crear etiquetas específicas efectivas se debe preguntar: 1. De qué se trata? (La respuesta dará una posible etiqueta para el bloque) 2. Qué dice al respecto? (La respuesta dará una etiqueta más específica que la pregunta anterior)

11 Explicación Etiquetas de bloques Una etiqueta combinada contiene las siguientes partes: Una etiqueta independiente del tema (eit) Una etiqueta específica del tema (eet) La parte correspondiente a la eit relaciona el bloque con otro semejante para facilitar la búsqueda e indica su propósito o función. La correspondiente a la eet resalta el contenido que se encuentra dentro del bloque.

12 información. Explicación Tipos de información Es esencial identificar el tipo de información para seguir correctamente el método Mapeo de Información, independientemente del tipo de documentación que se debe escribir. Prácticamente todos los trabajos escritos referentes a los documentos técnicos requieren de un conocimiento teórico de los tipos de

13 Explicación Tipos de información Los tipos de información se dividen en siete categorías básicas dentro de las cuales puede colocarse toda la información, tomando como punto de partida el propósito fundamental para el lector.

14 Conclusión Vimos la etiqueta independiente del tema que permite la identificación de una parte importante de la propuesta de escritura. En cualquier documento, las etiquetas independientes del tema aseguran consistencia aumentando la comprensión del lector. Después vimos las etiquetas específicas del tema por ejemplo puede ser el borrador de un curso de capacitación para usar una computadora puede incluir estas etiquetas sobre el tema: Unidad de proceso central; Lenguaje de computadora; Monitor; Teclado; Cursor

15 Referencias González, M. (2005). Documentación. México: UNID. UNID. (2013) etiquetas de bloques. Maestría en tecnologías de información documento obtenido de ormacion/doc_tecnica/sesion5/actividades/dt_etiqtipinf.pdf

16