Clase 7 de 20 • Curso de Introducción al Technical Writing y Documentación de Código
Contenido del curso
La voz verbal es todo un fenómeno. Sirve para marcar la relación que tiene el sujeto con el verbo. El verbo tiene dos voces: voz activa y voz pasiva. Aunque en español es un poco difícil de comprender, la usamos de manera inconsciente en nuestro día a día, así que quizás ahora que leas este capítulo prestes atención a la estructura que das a tus oraciones, ya sea al hablar o escribir.
Definición de voz activa y voz pasiva 🤓
La voz activa es el estándar para el technical writing. La mayor parte de las frases en la escritura técnica están en voz activa debido a que es más corta e interesante de leer. Además, la voz activa muestra claramente al sujeto en una situación, cuando leemos en esta voz gramatical sabemos quién hace qué y a quién.
Por otro lado, está la voz pasiva. Como su nombre lo indica, el sujeto aparece como paciente. Se hace énfasis en un estado o en una acción.
Ejemplos de voz activa y voz pasiva 💥
La voz activa nos muestra que los actores son "Ellos", en cambio, con la voz pasiva "ellos" quedan opacados.
De nuevo, la voz activa nos muestra que el actor es "El estudiante" y en la voz pasiva "el estudiante" queda sin mucha importancia.
Las frases que tienen la palabra "por" son casi siempre pasivas y sus verbos terminan en tiempo pasado participio: "hablado", "editado", etcétera. No obstante, si tienes una frase pasiva, la puedes convertir en activa. Solo pones al actor de tu oración al inicio y listo.
Estructura para oraciones cortas 👷♀️
En resumen, podríamos estructurar las oraciones cortas de la siguiente manera:
Identifica verbos pasivos 🕵️♀️
Puedes identificar fácilmente los verbos pasivos, normalmente siguen la siguiente fórmula:
Ejemplos:
Los verbos en participio normalmente terminan en -ado y en -ido. Algunos ejemplos son:
Es importante mencionar que existen algunos verbos en participio que son irregulares, es decir, que no necesariamente terminan en -ado o en -ido. Por ejemplo:
Si la frase contiene un sujeto, normalmente la preposición "por" sigue al verbo pasivo. Esta preposición suele ser una ayuda para detectar la voz pasiva. Ejemplos:
Los verbos imperativos son voz activa 😌
Un verbo en modo imperativo se usa para dar una indicación, orden o consejo. Cuando hacemos listas (tema que veremos en un futuro) lo recomendado es que las frases inicien con un verbo en modo imperativo. Por ejemplo:
Estas frases que usan al inicio un verbo en modo imperativo están en voz activa, aunque no mencionan directamente a un sujeto, ya que el sujeto implícito eres tú.
¡Practiquemos ejemplos complejos de voz activa y pasiva! 💪
Este tema es complejo y traté de hacerlo lo más digerible para ti. Las frases que te compartí en los ejemplos anteriores son sencillos y con un solo verbo. Adicional a lo explicado, tengo que compartirte que a lo largo de tu profesión como technical writer te encontrarás con frases que contienen más de un verbo. Te comparto unos últimos ejemplos.
En esta oración todo es voz pasiva:
Esta es la misma oración convertida parcialmente a voz activa:
Misma oración convertida en su totalidad a voz activa:
La voz activa es mejor que la voz pasiva 🔥
Te recomiendo que uses con mayor frecuencia la voz activa que la voz pasiva. Cuando leemos nuestra mente tiende a convertir la voz pasiva en activa. Si usamos la voz activa, ahorramos tiempo a nuestro lector en procesar la información.
La voz pasiva da muchas vueltas a algo sencillo. Sí, informa la acción, pero de manera indirecta y opacan al sujeto por completo. La voz activa es mejor que la voz pasiva porque te ayuda a ser corto, claro y directo.
¿Puedes cambiar el tipo de voz en una oración? 👊
Como reto de esta clase reescribe estas oraciones de voz pasiva a voz activa:
values/.¡Deja tu solución a los ejercicios en la sección de comentarios! En el próximo módulo estudiaremos buenas y malas prácticas para que nuestros escritos sean claros y bien estructurados.
Jacqueline Jimenez Plascencia
Nestor Jesus Rodriguez Rodriguez
Cristian Dario Prieto Avella
Juan Esteban Galvis
Luberliz Cueva Llanos
María Fernanda Magallanes Z
Gonzalo Gramaglia
Victor Vega
Jose Luis Idarraga
Hugo Leonardo Anaya Caceres
Ludwing Juan Homero Pérez Tzaquitzal
Fabiola Dayana Acarapi Alvarez
Juan David Sánchez
Cristian Blandon
Ivan Daniel Cuevas
Jesús Ramón Beltrán Chan
Luis Miguel Falcon Montaño
Luis Carlos
Kelly Paola González Martínez
Carlos Guevara
Jazziel Horacio Puente Verdugo
Francisco Enrique Giménez Vera
Yo lo tengo así:
La verdad tengo la duda, porque en algunos momentos pensaba como tienes escrito y después como escribí; la verdad no se si se pueden intercambiar o exista diferencia alguna :thinking:
La preposición "En" es solo ruido. No afecta en nada al mensaje de la oración si se quita.
(Pasiva) Varios recursos son descritos en los archivos del directorio values/. -> (Activa) Los archivos del directorio values/ describen varios recursos.
(Pasiva) Un único recurso es definido en cada campo secundario del elemento <resources>. -> (Activa) El elemento <resources> define en cada campo secundario un único recurso
(Pasiva) Son tus recursos predeterminados los recursos que han sido guardados en los subdirectorios definidos. -> (Activa) En los subdirectorios definidos han sido guardados tus recursos predeterminados
Voz pasiva
Voz activa
📌 Lo que considero más importante: . ▶ La voz activa es el estándar para el technical writing. La mayor parte de las frases en la escritura técnica están en voz activa debido a que es más corta e interesante de leer. Además, la voz activa muestra claramente al sujeto en una situación, cuando leemos en esta voz gramatical sabemos quién hace qué y a quién. . ▶ Cuando hacemos listas lo recomendado es que las frases inicien con un verbo en modo imperativo. Por ejemplo:
Los recursos son descritos en los archivos del directorio values/ El elemento <resource> define un recurso por cada campo secundario Tus recursos predeterminados son guardados en el subdirectorio definido
Se describen los recursos en los archivos del directorio values/.
En cada campo secundario del elemento se define un unico recurso<resources>
Los subdirectorios definidos guardan tus recursos predeterminados.
En los archivos del directorio values/ se describen varios recursos. En cada campo secundario del elemento, se define un único recurso En los subdirectorios definidos, se guardan tus recursos predeterminados.
Aquí está mi solución al reto Primera oración:
Los archivos del directorio values/ describen varios recursos.
Segunda oración:
Cada campo secundario del elemento define un único recurso.
Tercera oración:
Los recursos que han sido guardados en los subdirectorios definidos son tus recursos predeterminados.
¡Hola! A continuación el desarrollo del reto:
Varios recursos son descritos en los archivos del directorio values/.: Los archivos del directorio values/ describen varios recursos.
Un único recurso es definido en cada campo secundario del elemento.: En cada campo secundario del elemento se define un único recurso.
Son tus recursos predeterminados los recursos que han sido guardados en los subdirectorios definidos.: Tus recursos predeterminados se guardan en los subdirectorios definidos (no estoy seguro de ésta, aunque la idea es la misma :D).
¡Saludos!
Los archivos del directorio values/ describen varios recursos. Cada campo secundario del elemento define un único recurso. Los recursos guardados en los subdirectorios definidos son recursos predeterminados.
Varios recursos son descritos en los archivos del directorio values/.
En los archivos del directorio values/. se describen varios recursos
Un único recurso es definido en cada campo secundario del elemento .
Para cada campo secundario del elemento se define un único recurso
Son tus recursos predeterminados los recursos que han sido guardados en los subdirectorios definidos.
En los subdirectorios definidos se guardan tus recursos predeterminados
Los archivos del directorio son descritos en varios recursos
Un único recurso es definido en cada campo secundario del elemento. En cada campo secundario del elemento es definido un único recurso.
En los subdirectorios definidos han sido guardados tus recursos predeterminados.
Los archivos del directorio son descritos en varios recursos.
Un único recurso es definido en cada campo secundario del elemento.
En cada campo secundario del elemento es definido un único recurso.
En los subdirectorios definidos han sido guardados tus recursos predeterminados.
En los archivos del directorio están descritos varios recursos
En cada campo secundario del elemento hay un único recurso definido
En los subdirectorios definidos se guardan tus recursos predeterminados
En los archivos del directorio values/ están descritos varios recursos. En cada campo secundario del elemento se define un único recurso. En los subdirectorios definidos se han guardado tus recursos predeterminados.