Saltar al contenido principal
Library homepage
 
LibreTexts Español

2.6: Instrucciones

  • Page ID
    103233
  • \( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \) \( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)\(\newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\) \( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\) \( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\) \( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\) \( \newcommand{\Span}{\mathrm{span}}\) \(\newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\) \( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\) \( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\) \( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\) \( \newcommand{\Span}{\mathrm{span}}\)\(\newcommand{\AA}{\unicode[.8,0]{x212B}}\)

    Obejetivos de aprendizaje

    Al finalizar este capítulo, los lectores podrán hacer lo siguiente:

    1. Analizar y evaluar un conjunto de instrucciones técnicas.
    2. Escriba instrucciones claras y precisas con una introducción y conclusión.
    3. Desarrollar y diseñar un manual de instrucciones para un público específico.

    El enfoque de este capítulo es uno de los usos más importantes de la escritura técnica: las instrucciones. Como sabes, las instrucciones son esas explicaciones paso a paso de cómo hacer algo: cómo construir, operar, reparar o mantener cosas.

    Instrucciones de escritura

    Uno de los usos más comunes y uno de los más importantes de la escritura técnica son las instrucciones, esas explicaciones paso a paso de cómo hacer las cosas: armar algo, operar algo, reparar algo o hacer mantenimiento de rutina en algo. Pero para algo aparentemente tan fácil e intuitivo, las instrucciones son algunos de los documentos peor escritos que puedes encontrar. Como yo, probablemente hayas tenido muchas experiencias exasperantes con instrucciones mal escritas. Lo que sigue en este capítulo puede no ser una guía infalible, a prueba de errores para escribir instrucciones, pero te mostrará lo que los profesionales consideran las mejores técnicas.

    En última instancia, una buena escritura de instrucción requiere:

    • Escritura clara y concisa
    • Un profundo conocimiento del procedimiento en todos sus detalles técnicos
    • Tu habilidad para ponerte en el lugar del lector, la persona que intenta usar tus instrucciones
    • Su capacidad para visualizar el procedimiento con gran detalle y captar esa conciencia en papel
    • Por último, tu disposición a recorrer esa distancia extra y poner a prueba tus instrucciones sobre el tipo de persona para la que las escribiste.

    A estas alturas, probablemente hayas estudiado encabezados, listas y avisos especiales; escribir un conjunto de instrucciones con estas herramientas probablemente parezca obvio. Simplemente divida la discusión en listas verticales numeradas y agregue algunos avisos especiales en los puntos obvios y ¡listo! Bueno, no del todo, pero ese es un gran comienzo. Este capítulo explora algunas de las características de las instrucciones que pueden hacerlas más complejas. A su vez, puede utilizar estas consideraciones para planificar sus propias instrucciones.

    Algunos Preliminares

    Al inicio de un proyecto para escribir instrucciones, es importante determinar la estructura o características del procedimiento particular sobre el que vas a escribir. Particularmente en las instrucciones técnicas, su comprensión del procedimiento podría marcar la diferencia entre el éxito y el fracaso, o en niveles más complejos, la vida y la muerte.

    Al principio del proceso, defina la audiencia y situación de tus instrucciones. Recuerde que definir una audiencia significa definir su nivel de familiaridad con el tema así como otros detalles, incluyendo la edad y el nivel de habilidad. Vea la discusión de audiencias y pasos a utilizar en la definición de audiencias.

    Si estás en un curso de escritura, es posible que necesites escribir una descripción de tu audiencia y adjuntarla a tus instrucciones. Esto permitirá que su instructor evalúe sus instrucciones en términos de su rectitud para el público objetivo. Y recuerda también que en un curso de escritura técnica es preferible escribir para audiencias no especializadas, mucho más un desafío para ti como escritor.

    A continuación, examine el procedimiento que está describiendo para determinar el número de tareas. ¿Cuántas tareas hay en el procedimiento sobre el que estás escribiendo? Usemos el término procedimiento para referirnos a todo el conjunto de actividades que pretenden discutir tus instrucciones. Una tarea es un grupo semi-independiente de acciones dentro del procedimiento: por ejemplo, poner el reloj en un horno microondas es una tarea en el gran procedimiento general de operar un horno microondas.

    Un procedimiento sencillo como cambiar el aceite en un automóvil contiene una sola tarea; no hay agrupaciones semiindependientes de actividades. Dentro de esa tarea hay una serie de pasos, como quitar el tapón, drenar el aceite viejo, reemplazar el filtro y agregar el aceite nuevo. Si estuvieras escribiendo instrucciones para mantener tu auto tú mismo para ahorrar dinero, tendrías varias tareas, algunas que son independientes, como rotar las llantas, revisar los fluidos o reemplazar las escobillas del limpiaparabrisas.

    Un procedimiento complejo como usar un horno microondas es otro ejemplo de un procedimiento que contiene muchas tareas semiindependientes: configurar el reloj; establecer el nivel de potencia; usar el temporizador; y limpiar y mantener el microondas.

    Puede haber más en tus instrucciones que solo tareas. Algunas instrucciones solo tienen una sola tarea, pero tienen muchos pasos dentro de esa única tarea. Por ejemplo, imagina un conjunto de instrucciones para armar un juego de columpios para niños. En mi propia experiencia, ¡hubo más de 130 pasos! Eso puede ser un poco desalentador. Un buen enfoque es agrupar pasos similares y relacionados en fases, y comenzar a renumerar los pasos en cada nueva fase. Una fase entonces es un grupo de pasos similares dentro de un procedimiento de una sola tarea. En el ejemplo del columpio, configurar el marco sería una fase; anclar la cosa en el suelo sería otra; y ensamblar el columpio de caja sería otra más.

    Otra consideración, que tal vez no puedas determinar desde el principio, es cómo enfocar tus instrucciones. Para la mayoría de las instrucciones, puedes enfocarte en tareas o puedes enfocarte en herramientas (o características de herramientas). Tu enfoque dependerá de tu objetivo general al escribir las instrucciones, y encontrarás que el enfoque de tareas es uno que probablemente usarás con más frecuencia, con la discusión de las herramientas incluidas en notas o secciones complementarias como un glosario.

    “Utilice la orientación de tareas. Concéntrese en las tareas que sus lectores quieran realizar; use cómo o -ing fraseo en los encabezados”.

    En un enfoque de tareas (también conocido como orientación de tareas) a las instrucciones sobre el uso de un servicio de respuesta telefónica, tendría estas secciones:

    • grabando tu saludo
    • reproducir tus mensajes
    • guardar tus mensajes
    • reenviar tus mensajes
    • eliminar sus mensajes, y así sucesivamente

    Estas son tareas, las cosas típicas que nos gustaría hacer con la máquina.

    Por otro lado, en un enfoque de herramientas a las instrucciones sobre el uso de una fotocopiadora, habría estas secciones poco probables:

    • botón de copia
    • botón cancelar
    • botón de agrandar/reducir
    • botón de collate/grapa
    • botón de tamaño de copia, y así sucesivamente

    Si diseñaste un conjunto de instrucciones en este plan, escribirías los pasos para usar cada botón o función de la fotocopiadora. Las instrucciones que utilizan este enfoque son difíciles de hacer funcionar. A veces, el nombre del botón no coincide exactamente con la tarea a la que está asociado; a veces hay que usar algo más que un solo botón para realizar la tarea. Aún así, puede haber momentos en que el enfoque de herramientas/características puede ser preferible.

    Por último, tienes que decidir cómo vas a agrupar tareas si hay más de una. Simplemente enumerar las tareas puede no ser todo lo que necesita hacer. Puede haber tantas tareas que debes agruparlas para que los lectores puedan encontrar más fácilmente las individuales. Por ejemplo, las siguientes son agrupaciones de tareas comunes en las instrucciones:

    1. tareas de desembalaje y configuración
    2. instalación y personalización de tareas
    3. tareas operativas básicas
    4. tareas de mantenimiento rutinario
    5. tareas de solución de problemas; y así sucesivamente

    Secciones Comunes en Instrucciones

    La siguiente es una revisión de las secciones que encontrarás comúnmente en las instrucciones.

    Captura de pantalla 2020-05-18 a 21.12.48.png

    Figura\(\PageIndex{1}\)

    Título. Naturalmente necesitas uno, y debe ser conciso. Evite cadenas de nombres incómodas como “Increíbles instrucciones para hornear rollos de pizza” y en su lugar opte por el “cómo”, como “Cómo limpiar tu microondas G.E” o el gerundio, o frase de palabras -ing, como “Mantener tu iPhone de Apple”.

    Fecha. Con instrucciones técnicas, la fecha es crucial. Permite al lector estar seguro de que estas instrucciones son las más actuales, y si no lo son, a dónde pertenecen estas instrucciones en la línea de documentos relacionados con este producto o procedimiento.

    Tabla de Contenidos. Si tus instrucciones constan de múltiples tareas o tienen múltiples secciones, o si están siendo presentadas en forma de manual, es necesario un índice.

    Introducción. Planifique cuidadosamente la introducción a sus instrucciones. Asegúrese de que haga alguna de las siguientes cosas (pero no necesariamente en este orden) que se aplican a sus instrucciones particulares:

    • Indicar las tareas o procedimientos específicos a explicar así como los alcances de cobertura (lo que no se cubrirá).
    • Indicar lo que el público necesita en términos de conocimientos y antecedentes para entender las instrucciones. También puede especificar la edad de la audiencia aquí.
    • Dar una idea general del procedimiento y lo que logra. Si se trata de un largo conjunto de instrucciones, indique cuánto tiempo puede ser necesario para completar la tarea o procedimiento.
    • Indicar las condiciones en las que estas instrucciones deben (o no deben) ser utilizadas.
    • Dar una visión general del contenido de las instrucciones.

    Advertencia general, precaución, avisos de peligro. Las instrucciones a menudo deben alertar a los lectores sobre la posibilidad de arruinar su equipo, arruinar el procedimiento y lastimarse. Además, las instrucciones a menudo deben enfatizar puntos clave o excepciones. Para estas situaciones, usa avisos especiales: nota, advertencia, precaución y avisos de peligro. Por lo general, peligro significa que existe un riesgo de lesiones corporales graves o muerte; advertencia significa que existe un riesgo real de daño corporal o daño mayor al producto; precaución significa tener cuidado aquí, puede haber un riesgo; y una nota se usa para explicar detalles, o decir cómo dar problemas a un paso dentro de una tarea.

    Antecedentes técnicos o teoría. Al inicio de ciertos tipos de instrucciones (después de la introducción, por supuesto), es posible que necesite una discusión de antecedentes relacionados con el procedimiento. Para ciertas instrucciones, este trasfondo es crítico; de lo contrario, los pasos en el procedimiento no tienen sentido. Aquí es donde puedes mostrar tu experiencia en la redacción de definiciones y descripciones técnicas. Por ejemplo, es posible que haya tenido alguna experiencia con esos applets de software en los que define sus propios colores empujando barras deslizadoras rojas, verdes y azules alrededor. Para entender realmente lo que estás haciendo, necesitas tener algo de fondo sobre el color. Del mismo modo, se puede imaginar que, para ciertas instrucciones usando cámaras, también podría ser necesaria alguna teoría.

    Equipo y suministros. Observe que la mayoría de las instrucciones incluyen una lista de las cosas que necesita recopilar antes de comenzar el procedimiento. Esto incluye el equipo, las herramientas que usa en el procedimiento (como cuencos para mezclar, cucharas, sartenes para pan, martillos, taladros y sierras) y suministros, las cosas que se consumen en el procedimiento (como madera, pintura, aceite, harina y clavos). En las instrucciones, estos normalmente se enumeran en una lista vertical simple o en una lista de dos columnas. Use la lista de dos columnas si necesita agregar algunas especificaciones a algunos o todos los artículos, por ejemplo, nombres de marca, tamaños, cantidades, tipos, números de modelo, etc. Este puede ser un buen lugar para usar gráficos o visuales, especialmente si una herramienta necesaria es un artículo especial.

    Discusión de los pasos. Al llegar a la redacción real de los pasos, hay varias cosas a tener en cuenta:

    1. la estructura y el formato de esos pasos
    2. información complementaria que pueda ser necesaria
    3. el punto de vista y el estilo general de escritura

    Estructura y formato. Normalmente, imaginamos un conjunto de instrucciones como formateadas como listas numeradas verticales. Y la mayoría lo son de hecho. Normalmente, formatear sus instrucciones paso a paso reales de esta manera. Hay algunas variaciones, sin embargo, así como algunas otras consideraciones:

    • Los pasos de orden fijo son pasos que deben realizarse en el orden presentado. Por ejemplo, si estás cambiando el aceite en un auto, drenar el aceite es un paso que debe llegar antes de poner el aceite nuevo. Estas son listas numeradas (generalmente, listas numeradas verticales). En caso de duda, estructura tus instrucciones en este formato. Luego puede usar notas para indicar si hay algún margen de maniobra para realizar los pasos en otra secuencia.
    • Los pasos de orden variable son pasos que se pueden realizar en prácticamente cualquier orden. Buenos ejemplos son esas guías de solución de problemas que te dicen “verificar esto, verificar eso” donde intentas arreglar algo. Puedes hacer este tipo de pasos en prácticamente cualquier orden. Con este tipo, la lista con viñetas es el formato apropiado. Los pasos alternos son aquellos en los que se presentan dos o más formas de lograr lo mismo.
    • También se utilizan pasos alternativos cuando pueden existir diversas condiciones. Use listas con viñetas con este tipo, con “OR” insertado entre las alternativas, o el lead-in indicando que las alternativas están a punto de presentarse.
    • Los pasos anidados son aquellos en los que los pasos individuales dentro de un procedimiento pueden ser bastante complejos por derecho propio y deben dividirse en subpasos. En este caso, se sangra más y se secuencian los subpasos como a, b, c, y así sucesivamente.
    • Las instrucciones “Stepless” son aquellas que realmente no pueden usar listas verticales numeradas y que hacen poco o ninguna dirección sencilla al estilo instructivo del lector. Algunas situaciones deben ser tan generalizadas o tan variables que no se puedan afirmar pasos.

    Discusión complementaria. A menudo, no basta simplemente con decirle a los lectores que hagan esto o que hagan eso. Necesitan información explicativa adicional como cómo debe verse la cosa antes y después del paso; por qué deberían importarles hacer este paso; qué principio mecánico hay detrás de lo que están haciendo; y aún más explicación de micro-nivel del paso— discusión de las acciones específicas que conforman el paso .

    El problema con la discusión suplementaria, sin embargo, es que puede ocultar el paso real. Se quiere que el paso real —las acciones específicas que el lector va a tomar— se destaque. No quieres que todo esté enterrado en un montón de palabras.

    Existen al menos dos técnicas para evitar este problema: puedes dividir la instrucción del suplemento en párrafos separados; o puedes negrita la instrucción. El siguiente ejemplo te muestra una posible técnica para incluir discusión suplementaria para que no oscurezca las instrucciones.

    Cómo cambiar el aceite en seis pasos

    Al cambiar el aceite de motor, siempre revise el manual del propietario para encontrar la cantidad y el tipo de aceite y filtro correctos necesarios.

    1. Arranque el vehículo y permita que el motor se caliente por un minuto. Esto permite que el aceite existente en el motor se caliente para que drene muy suavemente.
    2. Localice el tapón de drenaje del cárter de aceite y retire el tapón para drenar. Retirar la tapa de llenado y tirar de la varilla de nivel de aceite permitirá un buen flujo para el aceite mientras se drena. Si hay más de un tapón, drene el aceite de ambos tapones en un recipiente.

    Precaución: Ten cuidado porque el aceite viejo puede estar caliente y podría quemarte.

    Pasos reales del usuario en negritas en las instrucciones. El texto en negrita ayuda a distinguir la acción real de la información complementaria.

    “Evitar la escritura telegráfica, omitiendo artículos “entendidos” (la, a, a). Es cierto que los robots escriben de esa manera, pero no tenemos que hacerlo”.

    Estilo de escritura. La forma en que realmente escribes instrucciones, frase por oración, puede parecer contradictoria con lo que te han enseñado las clases de escritura anteriores. Sin embargo, observe cómo se escriben las instrucciones del “mundo real”: usan muchos tipos de escritura imperativos (comando o dirección directa); usan mucho “usted”. Eso es totalmente apropiado. Quieres meterte en la cara de tu lector, conseguir su atención completa. Por esa razón, las frases estilo instrucción suenan así: “Pulsa el botón Pausa en el panel frontal para detener temporalmente la pantalla” y una nota aclaratoria podría decir “Debes tener cuidado de no...”

    Si tus instrucciones tienen que ser más formales, pregúntale a tu profesor sobre las preferencias para usar “tú”. Puede encontrar que la dirección directa no es apropiada para ciertos contextos.

    Para obtener las instrucciones más efectivas, comience cada paso con un verbo de acción.

    Nunca use la voz pasiva en las instrucciones. Por alguna extraña razón, algunas instrucciones suenan así: “Se debe presionar el botón Pausa para detener temporalmente la pantalla”. No sólo nos preocupa la salud mental del botón Pausa, sino que nos preguntamos quién se supone que deprime la cosa (¿me estás hablando?). O considere este ejemplo: “El botón Timer se establece entonces en 3:00”. Nuevamente, como la persona que sigue estas instrucciones, podrías perderte esto; podrías pensar que es simplemente una referencia a algún estado existente, o podrías preguntarte: “¿Me están hablando?” Casi tan malo es usar a la tercera persona: “El usuario debe entonces presionar el botón Pausa”. De nuevo, es la vieja doble toma: miras alrededor de la habitación y te preguntas: “¿Quién yo?”

    Otro de los problemas típicos con el estilo de escritura en las instrucciones es que la gente parece querer dejar de lado los artículos: “Presione el botón Pausa en el panel frontal para detener la visualización de información temporalmente” o “Earthperson, por favor proporcione la dirección del pizzería más cercano”. ¿Por qué hacemos esto? ¿Todos secretamente queremos ser robots? De todos modos, asegúrate de incluir todos los artículos (a, an, the) y otras palabras que normalmente usaríamos en las instrucciones.

    Conclusión. Realmente no quieres terminar tus instrucciones con el último paso. Una conclusión une perfectamente el proceso; ofrece información de resolución de problemas (es decir, qué hacer si algo salió mal); y, si está escribiendo las instrucciones como parte de su responsabilidad laboral, debe incluir información de contacto.

    Otro Back Matter. Su conjunto de instrucciones puede incluir una lista de referencias, un glosario o apéndice, un índice o especificaciones técnicas. Los elementos colocados aquí son importantes para las instrucciones generales porque proporcionan información adicional que ciertas audiencias pueden necesitar, pero que no son críticos para entender cómo completar el procedimiento.

    Gráficos e imágenes en instrucciones

    Probablemente más que en cualquier otra forma de escritura (excepto tal vez para los cómics), los gráficos son cruciales para las instrucciones. A veces, las palabras simplemente no pueden explicar el paso. Las ilustraciones suelen ser críticas para la capacidad de los lectores de visualizar lo que se supone que deben hacer. Considere el ejemplo de manuales de reparación de automóviles que realmente utilizan fotografías para ilustrar procedimientos, o capturas de pantalla que demuestran el proceso de uso del software.

    En un curso de escritura técnica, las instrucciones pueden requerir que incluyas ilustraciones u otro tipo de gráficos, lo que normalmente se usaría en las instrucciones. Solo asegúrate de que los gráficos que elijas sean apropiados y estén ubicados muy cerca de los escalones que ilustran. No hagas que tu audiencia voltee páginas para ver el gráfico que lo acompaña.

    Si no creas tus propios gráficos o imágenes, y los encuentras en otras fuentes, asegúrate de citar la fuente, preferentemente justo debajo del gráfico.

    Formato en Instrucciones

    Encabezados. En tus instrucciones, haz un buen uso de los encabezamientos. Normalmente, querría encabezados para cualquier sección de antecedentes que pueda tener, la sección de equipos y suministros, un encabezado general para la sección de instrucciones reales y subtítulos para las tareas o fases individuales dentro de esa sección. Echa un vistazo a los ejemplos al inicio de este capítulo.

    Listas. Del mismo modo, las instrucciones suelen hacer un uso intensivo de listas, particularmente listas verticales numeradas para las explicaciones paso a paso reales. Las listas verticales simples o las listas de dos columnas suelen ser buenas para la sección de equipos y suministros. Las listas de insentencia son buenas cada vez que das una visión general de las cosas por venir.

    Avisos especiales. En las instrucciones, debe alertar a los lectores sobre las posibilidades en las que puedan dañar sus equipos, desperdicios, hacer que todo el procedimiento falle, o lesionarse a sí mismos u otros, incluso de gravedad o muerte. Las empresas han sido demandadas por falta de estos avisos especiales, por avisos especiales mal escritos, o por avisos especiales que estaban fuera de lugar.

    Reemplazar el cuello de guitarra

    Si has seguido los pasos anteriores, ahora tu diapasón está festoneado. Lo único que queda por hacer es volver a armar tu guitarra. Para volver a armarlo, sigue estos pasos:

    1. Retire la cinta de los trastes.
    2. Inserte el cuello de nuevo en el cuerpo.
    3. Vuelva a colocar el panel metálico en su lugar y poner los tornillos. Nota: Asegúrese de volver a colocar cada tornillo firmemente en su lugar. Los tornillos mantienen el cuello seguro dentro del cuerpo. Si los tornillos no están instalados correctamente, la guitarra podría desarrollar problemas de entonación.
    4. Vuelva a encordar la guitarra.

    Montaje del NID

    Siga estas instrucciones para montar el dispositivo de interfaz de red (NID) en la pared:

    Advertencia: Siempre use anteojos de seguridad cuando use herramientas manuales. El mal uso de la herramienta o el rebote de herramientas eléctricas pueden resultar en lesiones oculares.

    1. Seleccione la ubicación para el NID. Este debe estar cerca de una toma de tierra eléctrica y ubicado en un lugar donde el cable del ISP llegará al NID. La tierra eléctrica se puede identificar como un cable de cobre proveniente del equipo de la compañía eléctrica en el exterior de su hogar.
    2. Taladre el NID en su lugar usando los tornillos. Deberá taladrar tornillos en las ranuras en la parte superior e inferior del NID.

    Sangría de avisos en instrucciones. En el primer ejemplo, observe cómo se sangra el aviso al texto del paso anterior. En el segundo ejemplo, observe que el aviso severo se coloca al principio antes de cualquiera de los escalones.

    Número, abreviaturas y símbolos. Las instrucciones también usan muchos números, abreviaturas y símbolos. Asegúrate de que los estás usando correctamente. Recuerde que si sus instrucciones pertenecen a un producto de marca para usar los símbolos de marca de manera apropiada.

    Lista de verificación de revisión para instrucciones

    A medida que relees y revisas tus instrucciones, ten cuidado con problemas como los siguientes:

    • Asegúrese de proporcionar instrucciones reales, explicaciones sobre cómo construir, operar o reparar algo.
    • Identificar dónde se utilizarán las instrucciones.
    • Escribe una buena introducción, en ella, indica el procedimiento exacto a explicar, indicar los requisitos de la audiencia y proporcionar una visión general de los contenidos.
    • Asegúrese de utilizar los distintos tipos de listas donde sea apropiado. En particular, utilice listas verticales numeradas para pasos secuenciales.
    • Use encabezados para marcar todas las secciones principales y subpartidas para las subsecciones. (Recuerda que no se necesita ningún encabezamiento “Introducción” entre el título y el primer párrafo. Recuerda no usar encabezamientos de primer nivel en esta tarea; empieza con el segundo nivel.)
    • Use avisos especiales según corresponda.
    • Asegúrese de usar el estilo y el formato para todos los encabezados, listas, avisos especiales y gráficos según lo especificado por su maestro para las tareas de escritura de instrucción.
    • Use gráficos para ilustrar cualquier acción u objeto clave, y asegúrese de que estén ubicados justo al lado o debajo del paso que ilustran y etiquetados correctamente.
    • Proporcionar una explicación complementaria adicional de los pasos necesarios.
    • Recuerde crear una sección con el listado de equipos y suministros, si es necesario.

    Algunas reflexiones finales sobre la escritura de instrucciones. Como escritor técnico o laboral, su capacidad para escribir buenas instrucciones conlleva una serie de implicaciones éticas. Ten en cuenta que las instrucciones mal o descuidadamente diseñadas te dejan a ti o a tu empresa responsables de los daños y perjuicios. También destruyen tu credibilidad y autoridad. Antes de enviar cualquier instrucción para la revisión final, asegúrese de tener otros ojos en ellos. Para procedimientos pequeños o rutinarios, puede ser suficiente que un compañero de trabajo los revise, pero las instrucciones más complejas siempre deben probarse para determinar su usabilidad. Asegúrate de haber leído el capítulo sobre Pruebas de usabilidad y realizado las pruebas necesarias antes de que tus instrucciones vayan a publicación y distribución.

    Ejercicios y Actividades

    Ejercicio 1

    Localiza un conjunto de instrucciones para un artículo que tienes actualmente. ¿Con qué eficacia cumplen estas instrucciones con los lineamientos presentados en este capítulo? Analiza cada parte de las instrucciones por separado y resume tus hallazgos en una nota a tu instructor. Prepárate para compartir ejemplos con la clase si estás en un aula presencial.

    Ejercicio 2

    Para discusión: Identifica los temas o preocupaciones éticas que debes abordar al crear instrucciones para lo siguiente: instalar un calentador de agua; cambiar los frenos de un automóvil; preparar una comida elaborada para un grupo grande; unir el ala a un avión de combate (bien, lo sé... esto es bastante obvio); políticas de oficina y procedimientos para nuevos empleados. ¿Se puede pensar en otras situaciones en las que se deben abordar preocupaciones éticas?

    Ejercicio 3

    Crear un manual de instrucciones. Esto se puede completar como un proyecto grupal o individual: Las instrucciones para esta actividad se pueden encontrar aquí. Tu profesor te brindará información y lineamientos adicionales.

    Asignación de Escritura: El Manual de Instrucción

    El propósito principal de esta tarea es darte práctica al escribir instrucciones y crear un manual, uno de los tipos más comunes de comunicación técnica que harás en el lugar de trabajo y en tu día a día. Algunas razones comunes para escribir instrucciones incluyen:

    • especificando detalles de las actividades técnicas
    • describiendo los procedimientos de oficina
    • elaboración de manuales de capacitación
    • explicando cómo operar programas de computadora
    • decirle a sus hijos (o adultos que actúan como niños) qué hacer

    Un aspecto importante de escribir instrucciones es el uso de gráficos y diseño: las buenas instrucciones contienen gráficos y están diseñadas para ser fáciles de leer y entender. Por lo tanto, otro propósito importante de esta tarea es mejorar tus habilidades en la dimensión visual de la comunicación técnica.

    Instrucciones: Crear un manual de instrucciones que dé instrucciones para completar un proceso. (Una lista de temas... y los temas que no debes usar... se proporciona al final de estas instrucciones, justo después de la rúbrica de evaluación).

    Luego, realice una prueba de usabilidad e incluya sus notas como se describe a continuación, y escriba una respuesta/reflexión de acuerdo con las pautas de esta tarea. Consulte el capítulo sobre usabilidad para obtener orientación adicional.

    Manual de instrucciones:

    • una página de título (enfocarla en la audiencia de la tarea, no en la tarea)
    • una tabla de contenido
    • una breve introducción
    • una definición técnica y descripción
    • materiales y/o equipos necesarios para llevar a cabo las instrucciones
    • advertencias y avisos de seguridad (incluya información de seguridad conforme a ANSI o ISO, según corresponda)
    • 3—4 páginas (longitud máxima) de instrucciones paso a paso (8-12 pasos)
    • debe incluir elementos visuales
    • todos los elementos gráficos deben tener un título (por ejemplo, Figura 1: Configuración del widget)
    • una conclusión con una declaración de comentarios
    • cualquier asunto relevante; esto puede incluir información de solución de problemas si es necesario.

    Tus instrucciones deben describir un proceso sencillo y fácil de llevar a cabo, algo que podrías llevar a cabo en un aula.

    Evite temas ilegales, poco éticos y potencialmente peligrosos, pero trate de encontrar algo interesante

    Puede obtener ideas de los conjuntos de instrucciones existentes en línea, pero debe escribir sus propias instrucciones.

    Notas de prueba de usabilidad

    A continuación, prueba tus instrucciones a un amigo o familiar y toma notas mientras llevan a cabo tu proceso. Podrías pedirles que piensen en voz alta mientras realizan el proceso, ¡pero no ayudes! Usa tus notas para revisar tus instrucciones si las necesitan.

    Envía una fotocopia/escaneo legible de las notas manuscritas que tomaste durante la sesión de prueba de usabilidad. Asegúrate de identificar tu “probador”. Incluye notas sobre lo que dijo tu probador durante el proceso, especialmente cualquier duda que te hiciera mientras llevabas a cabo las instrucciones.

    Memo Reflectante

    Escribe una nota reflexiva de 300 a 500 palabras, dirigida al instructor, en la que describas:

    • el enfoque retórico que utilizó para adaptar el documento a su audiencia
    • cómo cambiaron tus instrucciones como resultado de las pruebas de usabilidad
    • cuestiones éticas que encontraste
    • los objetivos del curso o módulo que encontraste al completar esta tarea.

    Explique sus respuestas.

    Rúbrica para evaluación

    La siguiente rúbrica es una posible guía para el maestro... o puedes usarla como lista de verificación para evaluar tu manual de instrucciones antes de enviarlo al teaher.

    Expectativa No cumple Cumple parcialmente: puede faltar uno o más componentes Cumple: Hiciste un gran trabajo logrando los estándares de instrucciones técnicas
    La portada es apropiada para el público y refleja los principios del buen diseño de documentos. 0 5 10
    El escritor ha incluido una tabla de contenidos. 0 3 5
    La introducción identifica a la audiencia e incluye al menos una definición y una descripción. 0 5 10
    Los materiales y equipos se presentan con cualquier explicación necesaria. 0 3 5
    Las alertas de seguridad y la información son adecuadas y se colocan correctamente. 0 3 5
    8 - 12 instrucciones paso a paso que comienzan con un verbo de acción. 0 10 20
    Al menos 3 elementos visuales/gráficos. 0 3 5
    Los elementos visuales/gráficos se colocan y subtitulan apropiadamente. 0 3 5
    Conclusión 0 3 5
    Volver materia si es necesario (solución de problemas, glosario, referencias citadas) 0 3 5

    Tabla\(\PageIndex{1}\): Rúbrica

    Un recordatorio: ¡se perderán puntos por cada error gramatical, mecánico o ortográfico! Me pongo mi camiseta Grammar Queen cuando gradúo.

    Sugerencias para Temas

    Siéntase libre de usar una de estas ideas, pero primero obtenga mi permiso. He visto alrededor de mil millones de ejemplos de “Cómo atar un nudo de Windsor” y no deseo ver otro mientras viva, y los proyectos de origami son más difíciles de documentar de lo que piensas. ¡Ni siquiera pienses en aviones de papel!

    • crear obras de arte/construir una nave
    • usando una función específica de un producto de software informático
    • edición de imágenes en Adobe Photoshop
    • crear un gráfico para una tarea escrita
    • presupuestación mensual efectiva
    • uso de funciones avanzadas de los programas de MS Office
    • tallar una calabaza
    • origami plegable (sin aviones de papel)
    • colorear huevos de pascua
    • uso de funciones avanzadas de Adobe Acrobat
    • escribir un programa de computadora simple
    • crear una página web básica
    • fabricación de animales de globo
    • alisar/rizar el cabello
    • atar nudos especiales en una corbata
    • atar bufandas
    • crear un arreglo floral
    • hacer alimentos simples
    • publicar un sitio web
    • realizar primeros auxilios o RCP

    Aquí hay un enlace a un conjunto anotado de instrucciones como ejemplo de cómo se hace. Un gran agradecimiento al Dr. Jonathan Arnett en KSU.

    Lista de comprobación

    • ¿Has incluido las tres partes de la tarea?
    • ¿La organización/contenido/diseño de las instrucciones muestra conciencia de la audiencia?
    • ¿Se indican claramente las tareas y el objetivo del usuario?
    • ¿Se identifica claramente el propósito de las instrucciones?
    • ¿Se abordan los temas de seguridad relacionados?
    • ¿El material frontal incluye una breve descripción técnica?
    • ¿El documento de instrucciones incluye una introducción, instrucciones paso a paso y una conclusión?
    • ¿Se incluyen los gráficos apropiados?
    • ¿El diseño del documento es limpio y profesional?
    • ¿Se detallan las notas de la sesión de pruebas de usabilidad de pensamiento en voz alta del usuario?
    • ¿La nota de respuesta reflectante incluye todos los elementos necesarios?
    • ¿El memo reflectante sigue el formato estándar de memo?
    • ¿La ortografía, la puntuación, la gramática y la edición de todo son limpias y profesionales?
    • ¿Funcionan realmente las instrucciones?

    This page titled 2.6: Instrucciones is shared under a CC BY license and was authored, remixed, and/or curated by Tiffani Reardon, Tammy Powell, Jonathan Arnett, Monique Logan, & Cassie Race.