ES/Documentation/Development

Equipo de documentación
El equipo de documentación en español es un grupo de voluntarios que se dedica, junto con los equipos de documentación de otros países, a la elaboración de documentación de LibreOffice. Nuestro equipo se dedica principalmente a la elaboración de guías y manuales, guías tipo cómo se hace, respuestas a preguntas frecuentes u otros documento que puedan ser útiles a cualquier usuario de LibreOffice. No nos dedicamos a la traducción de la interfaz ni a la ayuda del programa. Estas tareas las realiza el equipo de Localización. Actualmente, debido a la ausencia de autores en español, basamos nuestro trabajo en la documentación elaborada por otros equipos, principalmente en la documentación en inglés.

Cómo elaboramos la documentación
Tenemos, principalmente, dos formas de elaborar la documentación: la traducción y la actualización. Una vez elaborada la documentación de cualquiera de las dos formas, intentamos mejorarla con la revisión. En la traducción, partimos de documentos en inglés y los traducimos al español. Al tiempo que hacemos las traducciones, vamos actualizando las imágenes y capturas de pantalla para que el contenido de estas también se muestre en español. En la actualización, partimos de documentos de versiones anteriores ya traducidos y, basándonos en las guías en otros idiomas, elaboramos la nueva versión del documento. También actualizamos las imágenes. Esta forma de conseguir las guías requiere menos trabajo y suele ser más rápida. Una vez que el documento ha sido traducido o actualizado, se procede a su revisión. El objetivo es conseguir una documentación de calidad, sin errores ortográficos ni gramaticales y que sea fácilmente comprensible. La tarea de revisión comprende: la revisión de la traducción, revisión ortográfica y gramatical y revisión del contenido.

En la revisión de la traducción intentamos evitar fallos que se suelen cometer al traducir, tales como traducción de sustantivos como gerundios o empleo excesivo de la voz pasiva. La revisión ortográfica y gramatical pretende corregir aquellos errores que se hayan cometido en la traducción, generalmente suelen ser tildes olvidadas y poco más; la revisión gramatical pretende evitar aquellos errores gramaticales que a veces se cometen por una traducción literal del inglés. En la revisión del contenido se revisa que el texto esté claro, que las explicaciones sean comprensibles y que las imágenes se correspondan con los menús o diálogos que se muestran en pantalla al ejecutar el programa.

Cómo puedes colaborar
Para 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 se ajusta a lo que se ve describe o de muchas otras formas. Si nos comentas tus capacidades seguro que podemos encontrar algo adecuado para ti. Lo único que pedimos a los colaboradores es compromiso. No sirven de nada aquellas personas que manifiestan su intención de colaborar, se dan de alta, permisos, incluso, a veces, intentan cambiar el sistema o la organización del equipo y 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.

Para colaborar no te pedimos que dediques ni mucho ni poco tiempo, ni muchas aportaciones, únicamente lo que puedas aportar. Tampoco te pedimos una aportación continua, si ahora puedes dedicar menos tiempo, no importa o si puedes aportar más ¡estupendo! También puedes colaborar sin necesidad de unirte al equipo de documentación, puedes elaborar pequeñas guías tipo cómo se hace, respuestas a preguntas frecuentes u otro documento que pueda ser útil a cualquier usuario de LibreOffice. Basta con que aportes estos documentos elaborados o traducidos por ti y nos lo comuniques preferiblemente al foro de comunicación en español del equipo.

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

Cómo unirse al equipo de documentación
AltaColaborador Estaremos encantados de atenderte.
 * 1) Accede al foro de comunicación en español del equipo 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.
 * 3) Solicita permisos para edición de documentos siguiendo las instrucciones de la página:
 * También nos comunicamos mediante un grupo de Telegram, al que puedes unirte con: '''este el enlace.

Documentos para los colaboradores
Es importante leer los siguientes documentos antes de colaborar con en equipo de documentación:
 * [[Media:Guia_del_colaborador_V3.3.pdf |Guía del colaborador]]. -- Documento principal que explica cómo unirse a nuestro grupo, una descripción del proceso de documentación y directrices del estandar que utilizamos en las guías.
 * Guía de traducción y estilo de LibreOffice en español. Recomendaciones ortográficas y gramaticales para la traducción y redacción de las guías u otros documentos.
 * [[Media:Acceso_nextcloud.pdf |Guía breve del uso de Nextcloud]]
 * y los videos:
 * Introducción a la documentación
 * Realizar correctamente los movimientos en Nextcloud
 * Cómo insertar/cambiar las imágenes de las guías
 * Cómo traducir con Matecat

Personas que necesitamos

 * Autores: que quieran participar escribiendo documentación técnica o que ya la hayan escrito y quieran compartirla con nosotros.
 * Traductores: que colaboren traduciendo documentación escrita en otros idiomas. Aunque la documentación más abundante está en inglés, también son útiles traductores de otros idiomas, especialmente francés y alemán.
 * Revisores: que se encarguen de la corrección ortográfica y gramatical del documento, que comprueban que las descripciones y pasos descritos en los documentos se ajustan a los programas.
 * Editores: que comprueban que el formato de los documentos es adecuado y que cumplen con los estándares de publicación de LibreOffice.
 * Indexadores: que ayuden a crear índices adecuados para incluir en los documentos publicados.
 * Investigadores: que investiguen nuevas funcionalidades o posibilidades y las pongan en conocimiento del equipo para que puedan ser documentadas.
 * Diseñadores gráficos: que puedan colaborar en el diseño de portadas e ilustraciones de los documentos, en la elaboración de material de marketing o con gráficos o ilustraciones para las páginas web.
 * Diseñadores o programadores web:que nos ayuden a mejorar la imagen y funcionalidad de nuestras páginas web.
 * Cualquier otra habilidad: seguro que es útil si desea 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. Continuaremos actualizando las guías de Writer y Calc.

Dónde publicamos la documentación

 * En la página oficial de documentación de LibreOffice en español
 * También la publicamos en nuestra wiki

Listas de discusión para documentación de LibreOffice
Se pueden consultar los mensajes anteriores a Junio de 2022 en los Archivos de la lista e discusión para la documentación en español
 * Mail-Archive.com: https://www.mail-archive.com/documentation@es.libreoffice.org

La lista global de discusión para documentación (en inglés) es [mailto:documentation@global.libreoffice.org documentation@global.libreoffice.org]
 * Suscripción: [mailto:documentation+subscribe@global.libreoffice.org documentation+subscribe@global.libreoffice.org]
 * Suscripción al resumen: [mailto:documentation+subscribe-digest@global.libreoffice.org documentation+subscribe-digest@global.libreoffice.org]
 * Archivos: https://www.libreoffice.org/lists/documentation/
 * Mail-Archive.com: https://www.mail-archive.com/documentation@global.libreoffice.org
 * GMANE: http://dir.gmane.org/gmane.comp.documentfoundation.libreoffice.documentation

Lista de deseos para la documentación de usuario
Por favor, incorpore en la siguiente lista las cosas que desearía que se mejorarán en la documentación de usuario. Obviamente, no podemos hacer todo a menos que tengamos suficientes personas trabajando en ello, pero es muy útil tener una "lista de deseos": alguien puede ver la lista y decir "¡Yo puedo hacer eso!".


 * Guías de usuario en documentos ODT y PDF -- en proceso
 * Guías de usuario en el wiki
 * Preguntas y Respuestas (FAQs - en este wiki)
 * Guías de "Cómo se hace" (HowTos)
 * Tutoriales en formatos PDF y ODT
 * Tutoriales en video
 * Materiales de entrenamiento (¿Quizá hechos por otro grupo en la comunidad LibreOffice?)
 * Documentos dirigidos a públicos específicos, p.e. escritores técnicos, pequeñas empresas, estudiantes universitarios
 * [[Media:LibreOffice-TechWriterDocPlan.odt|DocPlan: Guide for Technical Writers]] - comentarios bienvenidos

Lista de deseos para documentación de desarrolladores
Por favor, agregue a esta lista las cosas que desea se incluyan en la documentación del desarrollador.


 * Empaquetamiento (.deb, .rpm, .dmg, .pisi,...)
 * UNO/LibreOffice Object Model (objetos, métodos y propiedades) ayudaría a desarrolladores de LibreOffice y macros. Algunos diagramas de la jerarquía del modelo de objetos ayudaría a los recién llegados a comenzar más rápido.
 * Flujo de trabajo del nivel de desarrollo incluyendo git, ejecutando soffice con el debugger y cuando construir todo/módulos.
 * FAQs para desarrolladores para las distintas fases del desarrollo. (Estas probablemente pertenecen a la sección de Desarrollo).