Redacción técnica

Compartir:

Estas preguntas solo se mostraron a los encuestados que se dedican a la redacción técnica.

El 12 % de los encuestados afirma dedicarse a la redacción técnica, aunque solo el 9 % tiene la redacción técnica como función oficial en su trabajo.

Cuando se les preguntó por su función, los encuestados pudieron elegir más de una opción.

¿Qué tipo de documentación redacta?

En comparación con el año pasado, observamos un aumento de 5 puntos porcentuales en el número de desarrolladores que elaboran documentación orientada al cliente.

¿Qué herramientas utiliza para crear documentación?

El enfoque «docs-as-code» está ganando popularidad, ya que cada vez más personas utilizan herramientas de desarrollo para crear documentación: 6 puntos porcentuales más que en 2021, para ser exactos.

¿Qué lenguaje de marcado utiliza para escribir documentación técnica?

Markdown sigue siendo el lenguaje de marcado más popular, y el 13 % de quienes se dedican a la redacción técnica utilizan versiones personalizadas de Markdown para enriquecer su funcionalidad básica.

¿Reutiliza contenidos entre distintos documentos o guías?

Aunque el 80 % de los encuestados necesita reutilizar contenidos, más de un tercio sigue copiando y pegando manualmente contenidos similares.

6 %

de los que escriben documentos automatizan las comprobaciones de la documentación. Las pruebas más utilizadas son las de marcado roto, enlaces externos y muestras de código. Curiosamente, el 10 % también automatiza las comprobaciones lingüísticas.

58 %

necesita documentar las API y el 61 % autogenera la documentación de las API, optando por utilizar Swagger la mayoría de las veces.

30 %

automatiza el trabajo rutinario mediante la configuración de plantillas, que en su mayoría automatizan distintos tipos de temas, documentos y contenidos repetidos.

¿Para qué tipo de tareas configura plantillas?

47 %

de los que utilizan plantillas crean plantillas parametrizadas.

¿Cuál es el idioma principal en el que redacta la documentación?

El inglés es, con diferencia, el idioma principal más utilizado para la documentación técnica. El chino le sigue de lejos.

68 %

de los redactores técnicos se ha planteado utilizar una herramienta profesional para la redacción técnica.

¿Ha pensado en utilizar una herramienta profesional para la redacción técnica?

El 13 % de los encuestados que se dedican a la redacción técnica ya localiza su documentación a otros idiomas, y el 10 % tiene previsto hacerlo.

WritersideEAP

¿Se encuentra usted entre el 68 % que está considerando una herramienta profesional para la creación de documentación?

Únase al programa de acceso anticipado para probar una nueva herramienta de redacción de documentos técnicos, que:

  • Funciona con IDE basados en IntelliJ.
  • Admite Markdown, marcado semántico y la combinación de ambos.
  • Cuenta con más de 100 pruebas integradas para la automatización de la calidad de los documentos.
  • Admite la reutilización de contenidos con condiciones y variables.
  • Cuenta con plantillas integradas para varios tipos de contenido y elementos de marcado complejos.
Redacción técnica:

2022

¡Gracias por el tiempo que nos ha dado!

Esperamos que nuestro informe le haya resultado útil. Comparta este informe con sus amigos y compañeros.

Participar en próximas encuestas

By submitting this form I agree to the JetBrains Privacy Policy

Datos brutos

Ya están disponibles los datos brutos de nuestra encuesta DevEco 2022. ¡Descargue, explore y saque sus propias conclusiones!

Descargar

Si tiene alguna pregunta o sugerencia, no dude en ponerse en contacto con nosotros a través de surveys@jetbrains.com.