Wikipedia:Haga que los artículos técnicos sean comprensibles

Esta página documenta una guía de edición de Wikipedia en inglés . Los editores deberían seguirlo en general, aunque pueden aplicarse excepciones . Las modificaciones sustanciales a esta página deben reflejar el consenso . En caso de duda, debatir primero en la página de discusión de esta guía .

Atajos WP:MTAU WP:TÉCNICO

Esta página en pocas palabras: esforzarse por hacer que cada parte de cada artículo sea lo más comprensible posible para la audiencia más amplia de lectores que probablemente estén interesados ​​en ese material.

Los artículos de Wikipedia deben escribirse para el público general más amplio posible .

Como enciclopedia libre, Wikipedia está al servicio de lectores con una amplia variedad de antecedentes, preparación, intereses y objetivos. Incluso en el caso de artículos sobre los temas más exigentes desde el punto de vista técnico, estos lectores incluyen, además de expertos, a estudiantes y legos curiosos. Si bien se deben mantener los objetivos de precisión, neutralidad y cobertura completa de los aspectos más importantes de un tema, se debe hacer todo lo posible para que los artículos sean accesibles y agradables de leer para los lectores menos preparados. Es especialmente importante hacer que la sección principal sea comprensible utilizando un lenguaje sencillo y, a menudo, resulta útil comenzar con subtemas más comunes y accesibles, y luego continuar con aquellos que requieren conocimientos avanzados o abordan especialidades específicas.

Los artículos deben redactarse en un estilo enciclopédico, pero esto difiere del estilo sobrio y técnicamente preciso que se encuentra en las monografías académicas y los artículos revisados ​​por pares dirigidos a especialistas. Los artículos deben ceñirse al tema sin distorsionar la verdad ni decir " mentiras para niños ", pero también deben ser independientes cuando sea posible y no deben dar por sentado el conocimiento previo ni utilizar gratuitamente una jerga inexplicable o una notación técnica avanzada: los atajos que ahorran tiempo y esfuerzo a los expertos pueden ser barreras para los no iniciados.

Wikipedia tiene una audiencia variada que puede calificarse de tres maneras:

• Sobre la familiaridad con el tema.
  • El lector general no tiene una educación avanzada en el campo del tema, no está familiarizado con el tema en sí e incluso puede no estar seguro de qué es el tema.
  • El lector informado tiene una formación en el campo del tema pero desea aprender sobre el tema en sí.
  • El lector experto conoce el tema pero quiere aprender más o recordar algún hecho, o siente curiosidad por la cobertura de Wikipedia.
• Sobre la capacidad de lectura. Varias herramientas gratuitas en línea pueden calificar automáticamente la legibilidad del texto o resaltar estructuras de oraciones complejas, como http://www.hemingwayapp.com ( índice de legibilidad automatizado )
• Por motivación a aprender sobre el tema.

Un lector muy instruido, informado y motivado puede leer cómodamente un artículo destacado de 5000 palabras hasta el final. Otro lector puede tener dificultades para leer el prólogo y mirar las imágenes. Un buen artículo captará el interés de todos los lectores y les permitirá aprender todo lo que puedan sobre el tema y estén motivados para hacerlo. Un artículo puede decepcionar porque está escrito muy por encima de la capacidad de lectura del lector, porque supone erróneamente que el lector está familiarizado con el tema o el campo, o porque cubre el tema a un nivel demasiado básico o no es exhaustivo.

Si bien un miembro de cualquiera de los grupos de audiencia puede encontrarse con un artículo y decidir leerlo (por ejemplo, haciendo clic en Special:Random ), algunos temas atraen naturalmente a una audiencia más limitada. Un tema que requiere muchos años de educación o capacitación especializada antes de ser estudiado o discutido, en general, es probable que tenga una audiencia más limitada. Por ejemplo, un tema en matemáticas avanzadas, derecho especializado o ingeniería industrial puede contener material que solo los lectores expertos pueden apreciar o incluso comprender. Por otro lado, muchos temas estudiados a un nivel académico avanzado siguen siendo de interés para una audiencia más amplia. Por ejemplo, el Sol es de interés para más que solo los astrónomos, y la enfermedad de Alzheimer interesará a más que solo los médicos.

La mayoría de los artículos de Wikipedia pueden redactarse de forma que resulten totalmente comprensibles para el lector general con una capacidad de lectura y motivación medias. Algunos artículos son de naturaleza técnica y otros tienen secciones o aspectos técnicos. Muchos de ellos pueden redactarse de forma que resulten comprensibles para un público amplio. Algunos temas son intrínsecamente complejos o requieren un gran conocimiento previo adquirido a través de una formación o educación especializada. No es razonable esperar que un artículo completo sobre estos temas sea comprensible para todos los lectores. Aun así, se debe hacer el esfuerzo de que el artículo resulte lo más comprensible posible para la mayor cantidad de personas posible, con especial énfasis en la sección introductoria. El artículo debe redactarse en un inglés sencillo que los no expertos puedan entender correctamente.

Wikipedia se esfuerza por ser una fuente de referencia seria, y en algunos artículos de Wikipedia todavía se pueden incluir temas muy técnicos. Aumentar la comprensión del contenido técnico tiene como objetivo mejorar el artículo para el beneficio de los lectores menos informados, pero esto debe hacerse sin reducir el valor para los lectores con más conocimientos técnicos.

Hacer que los artículos sean más comprensibles no significa necesariamente que se deba eliminar el contenido técnico detallado. Por ejemplo, se espera que un artículo de enciclopedia sobre un compuesto químico incluya las propiedades del compuesto, incluso si algunas de esas propiedades son oscuras para un lector general. Pero a menudo, resumir detalles altamente técnicos puede mejorar la legibilidad del texto tanto para lectores generales como para expertos. Por ejemplo, es poco probable que un lector general o un experto lean una demostración matemática extensa de algún resultado, pero un breve resumen de la demostración y sus puntos más importantes puede transmitir algo a un lector general sin reducir la utilidad para un lector experto. Al intentar decidir qué cantidad de detalles técnicos es apropiada incluir, puede ser útil comparar con una obra de referencia estándar en el campo técnico particular al que pertenece el tema del artículo.

Es especialmente importante que la primera sección (la sección "introducción", encima del índice) sea comprensible para un amplio grupo de lectores. Los lectores deben poder saber de qué trata un artículo y si están leyendo el artículo correcto, incluso si no conocen el tema en detalle. Aquellos que solo buscan un resumen o una definición general pueden dejar de leer al final de la introducción. Una introducción comprensible anima a los lectores a seguir leyendo el cuerpo del artículo.

Por estos motivos, la introducción debe ofrecer una visión general comprensible del artículo. Si bien la introducción tiene como objetivo mencionar todos los aspectos clave del tema de alguna manera, se puede mejorar la accesibilidad resumiendo el tema únicamente en la introducción y colocando los detalles técnicos en el cuerpo del artículo. La introducción del artículo debe indicar al lector general el campo de estudio del tema, el lugar que ocupa en su campo de estudio, para qué sirve el tema (si es que sirve para algo) y qué es necesario aprender primero para comprender el artículo.

En general, la introducción no debe dar por sentado que el lector está familiarizado con el tema del artículo. La terminología de la sección de introducción debe ser comprensible a primera vista para los lectores en general, siempre que esto se pueda hacer de una manera que aún resuma adecuadamente el artículo, y no debe depender de un enlace a otro artículo. Cualquier enlace a otro artículo debe ser un complemento para proporcionar más información y, preferiblemente, no debe ser necesario para comprender el texto de la introducción. Para temas altamente especializados en los que es difícil dar una descripción general en términos con los que esté familiarizado un público general, puede ser razonable dar por sentado algún conocimiento de fondo en la introducción al tiempo que se vincula a los requisitos previos necesarios para comprenderlo. Como referencia, la introducción de un artículo destacado típico incluye alrededor de 20 enlaces a otros artículos (con una longitud media de introducción de alrededor de 300 palabras).

A continuación se presentan algunas ideas más para abordar temas moderadamente o muy técnicos:

Está perfectamente bien que las secciones posteriores sean más técnicas, si es necesario. Aquellos a quienes no les interesan los detalles simplemente dejarán de leer en algún momento, por lo que el material que les interesa debe aparecer primero. Lo ideal es que las secciones vinculadas del artículo comiencen con un nivel técnico similar, de modo que si el primer párrafo de un artículo, más fácil, enlaza a una sección en el medio del artículo, la primera parte de la sección vinculada a él también sea comprensible. Además, incluso las secciones más técnicas a menudo se pueden mejorar resumiendo las ideas principales en el primer párrafo antes de entrar en detalles.

Evite las explicaciones circulares: no defina A en términos de B, ni B en términos de A. Verifique que no se utilicen términos técnicos antes de definirlos.

Una técnica general para aumentar la accesibilidad es considerar el nivel típico en el que se estudia el tema (por ejemplo, secundaria , pregrado o posgrado ) y escribir el artículo para lectores que estén en el nivel anterior. De este modo, los artículos sobre temas de pregrado pueden estar dirigidos a un lector con formación en secundaria, y los artículos sobre temas de posgrado pueden estar dirigidos a lectores con formación universitaria. La sección introductoria debe ser particularmente comprensible, pero el consejo de escribir un nivel más abajo se puede aplicar a todo el artículo, lo que aumenta la accesibilidad general. Escribir un nivel más abajo también respalda nuestro objetivo de proporcionar una fuente terciaria sobre el tema, que los lectores pueden utilizar antes de comenzar a leer otras fuentes sobre él.

Muchos artículos técnicos no son comprensibles (y resultan más confusos incluso para los lectores expertos) simplemente porque son abstractos. Un ejemplo concreto puede ayudar a muchos lectores a poner el contenido abstracto en contexto. A veces, un ejemplo contrastante (contraejemplo) también puede ser útil. Por ejemplo, del verbo article :

Un verbo , del latín verbum que significa 'palabra', es una palabra ( parte del discurso ) que en sintaxis transmite una acción ( traer , leer , caminar , correr , aprender ), un suceso ( suceder , convertirse ) o un estado del ser ( ser , existir , permanecer ).

Los ejemplos deben seguir cumpliendo el mismo requisito de no realizar ninguna investigación original al que están sujetos otros contenidos.

Cuando sea posible, incluso para los expertos, puede resultar útil explicar en inglés por qué la fórmula tiene determinadas características o está escrita de determinada manera. Explicar el "significado" de una fórmula ayuda a los lectores a seguir la lectura. Como mínimo, asegúrese de que todas las variables de una fórmula estén definidas en el artículo o tengan enlaces a artículos que las expliquen.

Las representaciones visuales permiten a muchas personas aprender de forma más eficaz y permiten comunicar conceptos técnicos de forma más concisa y clara. Los diagramas deben estar relacionados con descripciones simbólicas o verbales cuando sea apropiado. Algunas plantillas que pueden resultar útiles:

• {{Location map}}: superponer una imagen-símbolo + etiqueta sobre un mapa/imagen;
• {{Location map many}}: para superponer muchos símbolos de imagen + etiquetas en un mapa/imagen (hasta 9 marcadores);
• Module:Location map/data/100x100:tiene ejemplos para cualquier imagen como una cuadrícula superpuesta de 100 por 100;
• {{Superimpose}}: superponer sobre una imagen sin bordes, como diagramas abiertos.

Directriz principal: Lenguaje técnico en Wikipedia: Manual de estilo

• Utilice la jerga y las siglas con criterio. Explique los términos técnicos y amplíe las siglas cuando se utilicen por primera vez. Además, puede considerar utilizarlas con moderación a partir de entonces o no utilizarlas en absoluto. Especialmente si se introducen muchos términos nuevos a la vez, sustituir una palabra en inglés más conocida puede ayudar a reducir la confusión (siempre que no se sacrifique la precisión).
• Si no se pierde precisión, utilice términos comunes en lugar de términos técnicos . Sustituya los términos técnicos por términos comunes cuando sean completamente equivalentes.
• Considere la posibilidad de introducir las oraciones explicativas con advertencias. Cuando se ofrece una explicación menos completa o precisa para mejorar la claridad, introduzca una frase como "Generalmente..." o "Con algunas excepciones..." para que el lector sepa que hay más complejidad detrás de la explicación. Añada más detalles a las oraciones explicativas breves o incluya una sección de "definición sólida" para que el artículo en su conjunto sea completo y preciso.
• Elimina las cadenas largas de adjetivos , especialmente los adjetivos técnicos.
• Utilice oraciones y párrafos breves. La comprensión disminuye cuando la longitud de la oración supera las 12 palabras. Sin embargo, utilizar demasiadas oraciones cortas seguidas resulta monótono y forzado; varíe la longitud de la oración para mantener el interés del lector. De manera similar, divida los párrafos largos en párrafos más cortos.
• Utilice más verbos para mejorar la legibilidad. Puede reemplazar muchos adjetivos técnicos por verbos. Por ejemplo, en lugar de decir "El método X es el mejor", diga: "El método X mejora los resultados".
• Utilice un lenguaje similar al que utilizaría en una conversación. Muchas personas utilizan un lenguaje más técnico al escribir artículos y hablar en conferencias, pero trate de utilizar una prosa más comprensible en una conversación.
• Utilice analogías para describir un tema en términos cotidianos. Evite analogías exageradas. Las mejores analogías pueden marcar la diferencia entre la incomprensión y la comprensión total. Sin embargo, Wikipedia no es un libro de texto , por lo que las analogías deben redactarse de manera enciclopédica y ser atribuibles a fuentes confiables . Las explicaciones extensas sin una fuente específica pueden constituir una investigación original o una investigación original por síntesis .

Es importante no simplificar demasiado el material con el fin de hacerlo más comprensible. Los artículos de enciclopedia no deben " mentirles a los niños " en el sentido de ofrecer a los lectores un camino fácil para que sientan que entienden algo cuando no es así.

Hay varias plantillas disponibles para etiquetar artículos que no cumplen con los estándares de comprensibilidad acordados.

En el caso de artículos que no sean lo suficientemente comprensibles, la plantilla debe insertarse en la parte superior de la página de discusión correspondiente. Debe incluir una explicación en la página de discusión con comentarios sobre por qué cree que es demasiado técnico o sugerencias para mejorarlo . Las plantillas agregadas sin explicación probablemente serán ignoradas o eliminadas. Los artículos que contienen esta plantilla se pueden encontrar en Categoría:Artículos de Wikipedia que son demasiado técnicos .{{Technical}}

Esta etiqueta debe usarse solo en artículos que usted considere que podrían mejorarse si alguien siguiera las pautas mencionadas anteriormente.

Para temas que son inevitablemente técnicos pero, al mismo tiempo, de interés significativo para lectores no técnicos, una solución puede ser un artículo introductorio independiente. Un ejemplo es Introducción a los virus . Se puede encontrar una lista completa de los artículos actuales de "Introducción a..." en Categoría:Artículos introductorios , mientras que una lista de los artículos principales así complementados es Categoría:Artículos con introducciones independientes .

De acuerdo con el espíritu de la política WP:NOT de Wikipedia , la directriz WP:LEAD y la directriz sobre bifurcación de contenido , la cantidad de artículos introductorios separados debe mantenerse al mínimo. Antes de comenzar uno, pregúntese

• Siguiendo los consejos dados en los apartados anteriores, ¿es posible hacer que el artículo sea suficientemente comprensible en su conjunto, sin necesidad de una introducción aparte?
• Dado el grado de interés general en el tema en cuestión, ¿podría ser suficiente una introducción bien redactada?

Puede iniciar un artículo de "Introducción a..." si la respuesta a estas preguntas es "no".

• Wikipedia:Manual de estilo/Accesibilidad
• Wikipedia:Términos técnicos del gobierno de EE. UU.
• Wikipedia:Lista de artículos introductorios
• Wikipedia: Cómo escribir mejores artículos
• Wikipedia:Muchas cosas para muchas personas
• Wikipedia:WikiProject Anatomy/Simplificación de la terminología anatómica
• Wikipedia: WikiProject Matemáticas / Pruebas
• Meta:Nivel de lectura
• Plantilla:Técnica
• Plantilla:Explicado en exceso
• La Wikipedia en inglés simple tiene como objetivo proporcionar explicaciones completas utilizando un subconjunto limitado del inglés. Es un recurso tanto de ejemplos (artículos) como de consejos (directrices) sobre cómo utilizar un lenguaje más simple sin simplificarlo.

• "Tema: Escribir para la Web". Nielsen Norman Group .
  • Jakob Nielsen (1 de octubre de 1997). "Cómo leen los usuarios en la Web".
  • Hoa Loranger y Kate Meyer (23 de abril de 2017). "Cómo redactar textos digitales para expertos en el sector".
  • Hoa Loranger (8 de octubre de 2017). “El lenguaje sencillo es para todos, incluso para los expertos”.
• "15–Cómo escribir contenido web". Pautas de usabilidad y diseño web basadas en investigaciones (PDF) . Departamento de Salud y Servicios Humanos de los Estados Unidos. 15 de agosto de 2006. ISBN 0-16-076270-7.
• "Red de Información y Acción en Lenguaje Sencillo". Gobierno Federal de los Estados Unidos.
• "Directrices para la preparación de folletos educativos para pacientes". Centro de Práctica Profesional de Enfermería . UC Davis . Archivado desde el original el 7 de diciembre de 2013.