lunes, 11 de marzo de 2024 From rOpenSci (https://ropensci.org/es/blog/2024/03/11/r_open_sci_dev_guide_0_9_0_ahora_multiling%C3%BCe_y_mejor/). Except where otherwise noted, content on this site is licensed under the CC-BY license.
Las orientaciones de la Revisión por Pares de Software de rOpenSci se compilan en un libro en línea que sigue mejorando. Esta articulo de blog resume las novedades de nuestra Guía de Desarrollo 0.9.0, con todos los cambios enumerados en la sección registro de cambios.
Nuestra guía es ahora bilingüe (inglés y español), gracias al trabajo de Yanina Bellini Saibene, Elio Campitelli y Pao Corrales y gracias a el apoyo de la Iniciativa Chan Zuckerberg, NumFOCUS y el Consorcio R. Lee la guía en inglés.
Puedes obtener más información sobre nuestro proyecto de publicación multilingüe en los recursos y video de una reunión de la comunidad reciente. Entre las herramientas útiles producidas por el proyecto se incluyen la guía de traducción el paquete babelquarto para construir libros o sitios web Quarto multilingües, y el paquete babeldown para crear y actualizar traducciones utilizando la API de DeepL.
Ahora nuestra guía también se traduce a portugués gracias al esfuerzo de personas voluntarias de nuestra comunidad. ¡Estamos muy agradecidos por su trabajo!
Hemos actualizado la sección Objetivos y ámbito de aplicación para incluir los paquetes de traducción, eliminar las categorías experimentales de tratamiento de textos y proporcionar aclaraciones sobre paquetes que consumen APIs.
En nuestra guía para personas que desarrollan paquetes ahora nos referimos correctamente a la etapa del ciclo de vida “Estable” como aquella en la que se puede enviar un paquete, gracias a una contribución del usuario de GitHub bart1.
Hemos creado una Hoja de trucos para las personas que mantienen paquetes de rOpenSci sobre cómo pedir ayuda sobre distintos temas.
El capítulo de la guía de desarrollo de paquetes ha recibido varias mejoras.
Hemos actualizado los consejos sobre roxygen2 enlazando principalmente con el sitio web de roxygen2. Los consejos también incluyen una explicación de cómo documentar un argumento por defecto, gracias a Hugo Gruson. También hemos mejorado nuestra redacción para hacer hincapié en que el uso de roxygen2 sigue implicando esfuerzos manuales (gracias a Vincent van Hees).
Hemos añadido consejos para paquetes que consumen APIs web basados en la entrada del blog “Por qué deberías (o no deberías) construir un cliente API”.
Nuestras instrucciones sobre Ficheros de CITA reflejan ahora las nuevas políticas de CRAN.
Nuestra lista de paquetes de ayuda a las pruebas incluye ahora shinytest2, que prevemos que acabará sustituyendo a shinytest.
Nuestro capítulo sobre colaboración incluye más enlaces a recursos sobre, por ejemplo, revisiones de PR y flujos de trabajo Git gracias a Mauro Lepore. Ese mismo capítulo menciona ahora Discusiones en GitHub como forma de comunicarse las personas que usan el paquete y más detalles sobre plantillas de issues.
Edward Wallace añadió una explicación de la integración continua (CI) en general y de la codecov en particular a nuestra guía CI.
Ahora destacamos los valores de nuestro sistema y el tono que nos esforzamos por conseguir en más lugares: en la parte superior de la guía para quienes revisan, en la plantilla para las solicitudes de revisión y en el mensaje que nuestro bot publica después de que quienes editan asignan las personas que revisaran.
La comunidad de rOpenSci es nuestro mejor activo. Nuestro objetivo es que las revisiones sean abiertas, no conflictivas y centradas en mejorar la calidad del software. ¡Sé amable! Consulta nuestra guía de revisión y el código de conducta para más información.
Alexander Fischer añadido una explicación sobre el envío de paquetes a través de ramas no predeterminadas a la página guía para autores y autoras y a la guía para las personas que revisan.
Nuestra guía para revisar explica ahora claramente cómo puedes ofrecerse voluntariamente para revisar, en general y para una presentación concreta.
En este articulo hemos resumido los cambios incorporados a nuestro libro “Paquetes rOpenSci: Desarrollo, mantenimiento y revisión por pares” en los últimos meses. Agradecemos todas las contribuciones que han dado forma a esta publicación. Ya estamos trabajando en la próxima versión, que incluirá una traducción al portugués gracias al esfuerzo y trabajo voluntario de personas de nuestra comunidad.
