Documentación/Desarrollo de documentación

From The Document Foundation Wiki
Jump to navigation Jump to search

Equipo de documentación en español

El equipo de documentación en español es un grupo de voluntarios que se dedica a la elaboración de documentación de LibreOffice en español.
Nuestro equipo se dedica principalmente a la elaboración de guías y otros documentos que puedan ser útiles a cualquier usuario de LibreOffice.
Actualmente, debido a la ausencia de autores en español, basamos nuestro trabajo en la documentación principalmente en la documentación en inglés.

No nos dedicamos a la traducción de la interfaz ni a la ayuda del programa. Estas tareas las realiza el equipo de regionalización.

Cómo elaboramos la documentación

Utilizamos dos métodos: la traducción y la actualización, y finalmente, intentamos mejorarla con la revisión.

Para la traducción, partimos de documentos en inglés y vamos actualizando las imágenes de las guías, para que el contenido también se muestre en español.
En la actualización, partimos de nuestros documentos y, basándonos en las guías en otros idiomas, elaboramos la nueva versión del documento.
Después de la traducción o actualización, hacemos varias revisiones para conseguir una documentación de calidad, sin errores ortográficos ni gramaticales y que sea fácilmente comprensible:

  • En las revisiónes intentamos evitar fallos propios de la traducción, como la traducción de sustantivos como gerundios o el empleo excesivo de la voz pasiva.
  • La revisión ortográfica y gramatical pretende corregir tildes olvidadas u otros lapsus ortográficos y evitar traducciones literales del inglés.
  • La revisión del contenido pretende que este sea claro, con explicaciones comprensibles e imágenes que se correspondan con lo que se ve al ejecutar el programa.

Cómo puedes colaborar

No se necesitan requisitos especiales. Si sabes inglés u otros idiomas puedes colaborar en las traducciones.
Si no, puedes colaborar en las revisiones, actualizando imágenes, comprobando que el contenido es coherente con lo descrito o de otras formas.

Si nos comentas tus capacidades seguro que podemos encontrar algo adecuado para ti.

Lo único que pedimos es un mínimo compromiso. No sirven de nada aquellas personas que manifiestan su intención de colaborar, se dan de alta, obtienen permisos
y luego pretenden cambiar el sistema u organización del equipo pero, a la hora de la verdad, no colaboran en absoluto.

Si no estás dispuesto a comprometerte, no pierdas tu tiempo ni nos hagas perder el nuestro.

No te pedimos que dediques ni mucho ni poco tiempo, o hagas muchas aportaciones, solamente lo que puedas aportar.
Tampoco una aportación continua, si ahora puedes dedicar menos tiempo, no importa, y si puedes aportar más ¡estupendo!
También puedes colaborar sin unirte al equipo, elaborando pequeñas guías, respuestas a preguntas frecuentes u otro documento útil para el usuario de LibreOffice.
Basta con que aportes esos documentos elaborados o traducidos por ti y nos lo comuniques preferiblemente al foro de comunicación del equipo español.

Otra forma de colaborar es enviando preguntas o sugerencias relacionadas con la documentación o con el equipo. No dudes en ponerte en contacto con nosotros.

Cómo unirse al equipo de documentación, medios de comunicación

Nos comunicamos por medio del foro de comunicación del equipo español, y También mediante un grupo de Telegram, al que puedes unirte en este el enlace.

Estaremos encantados de atenderte.
  1. Accede al foro de comunicación del equipo español y regístrate para poder crear un nuevo tema.
  2. Crea un nuevo tema (mensaje) indicando que quieres colaborar con el equipo y las funciones que podrías desarrollar: corrector, revisor, traductor, etc.
  3. Solicita los permisos para la edición de documentos siguiendo las instrucciones de la página: AltaColaborador
Note pin.svg

Nota:
Las respuestas se dan por el medio que hayas empleado, por lo que es conveniente que revises tus mensajes.

Documentos para los colaboradores

Es muy importante leer los siguientes documentos antes de colaborar con el equipo de documentación:

También es conveniente que veas los siguientes vídeos:

Introducción a la documentación

Acepte este video. Al aceptar, accederá al contenido de YouTube, un servicio proporcionado por una web externa.

Normativa de privacidad de YouTube

Movimientos de archivos en NextCloud

Acepte este video. Al aceptar, accederá al contenido de YouTube, un servicio proporcionado por una web externa.

Normativa de privacidad de YouTube

Cambiar las imágenes en las guías

Acepte este video. Al aceptar, accederá al contenido de YouTube, un servicio proporcionado por una web externa.

Normativa de privacidad de YouTube

Traducir con Matecat

Acepte este video. Al aceptar, accederá al contenido de YouTube, un servicio proporcionado por una web externa.

Normativa de privacidad de YouTube

Personas que necesitamos

  • Autores que escriban documentación técnica o que ya la hayan escrito y quieran compartirla.
  • Traductores para traducir la documentación en otros idiomas. Aunque la documentación más abundante está en inglés, también son útiles traductores de otros idiomas, especialmente alemán y francés.
  • Revisores para la corrección ortográfica y gramatical del documento, o que comprueben que las descripciones y pasos descritos en los documentos se ajustan a los programas.
  • Editores que comprueben que el formato de los documentos es adecuado y que cumplen con los estándares de publicación de LibreOffice.
  • Investigadores de las nuevas funcionalidades o posibilidades de los programas, que las comuniquen para que puedan ser documentadas.
  • Cualquier otra habilidad: seguro que es útil si deseas colaborar con nosotros.

Qué estamos haciendo ahora en el equipo de documentación

Nuestra meta a corto plazo es actualizar las guías a la versión 7

Actualmente estamos trabajando en la actualización de la Guía de iniciación a la versión 7.2 y Writer 7.3. Continuaremos actualizando la guía de Calc.

Guía Versión publicada Estado
Introducción 6.2 Trabajando en la versión 7.2
Writer 6.0 Trabajando en la versión 7.3
Calc 6.2 Próximamente
Base 6.2 Próximamente
Draw 6.4 Próximamente
Impress 7.0
Math 7.0

Dónde publicamos la documentación

Canales de comunicación con el equipo de documentación de LibreOffice

Note pin.svg

Nota:
Estamos en fase de renovación de nuestro sistema y es posible que algunas listas de correos no funcionen.

Equipo español

Actualmente nos comunicamos mediante:

Se pueden consultar los mensajes archivados del sistema antiguo en el Archivo de correos

Equipo global (En inglés)

Foro global del equipo de documentación