class: center, middle, inverse, title-slide # Revisar paquetes para una mejor ciencia ## Maëlle Salmon, rOpenSci <br/> <a href="https://twitter.com/ropensci"><i class="fab fa-twitter "></i></a> ropensci <a href="https://github.com/ropensci"><i class="fab fa-github "></i></a> ropensci <a href="https://ropensci.org"><i class="fas fa-globe "></i></a> ropensci.org ### 2019/09/26 --- # 👋 ¿Qué es rOpenSci? * Una comunidad científica y de desarrollo de software R * Apoyo a la ciencia abierta y reproducible * Paquetes R mantenidos por el personal y la comunidad -- 🔗 charla https://tiny.cc/latinr19 --- # Paquetes de rOpenSci 💁 rOpenSci mantiene paquetes para -- * Acceso a fuentes de datos de la web (`GSODR`, `opencage`) -- * Acceso a fuentes de datos... raras (PDF con `pdftools` y `tabulizer`, texto en imágenes con `tesseract`) -- * Herramientas de flujo de trabajo (`drake`, `gistr`) -- * ¡Y mucho más para facilitar su trabajo científico! https://ropensci.org/packages/ --- # Calidad de los paquetes de rOpenSci * Paquetes desarrollados por quienes trabajamos en rOpenSci o por la comunidad * ¡Sistema de revisión de paquetes! --- # rOpenSci Software Peer Review Revisiones abiertas de paquetes R. -- * Favorecer el uso de buenas prácticas y estándares -- * Crear una "comunidad de práctica" -- * Colaboración con el _Journal of Open Source Software_ y _Methods in Ecology and Evolution_ --- # ¿Qué mirar en paquetes? -- _.small[Jeff Leek @jtleek]_ ```r magick::image_read("https://raw.github.com/jtleek/rpackages/master/documentation.png") ``` <img src="index_files/figure-html/unnamed-chunk-1-1.png" style="display: block; margin: auto;" /> --- # Criterios de revisión * Licencia compatible con la Open-source initiative (OSI) * Buena cobertura de tests * Documentación completa * Código legible * Usabilidad -- [devguide.ropensci.org/](https://devguide.ropensci.org/) --- # ¿Cómo revisar? -- * De manera _abierta_ y no _contenciosa_ -- * Procedimiento constructivo para todas las personas involucradas -- * Utilizando la infraestructura de GitHub --- # rOpenSci Software Peer Review <img src="index_files/figure-html/onboarding-repo-1.png" width="1401" style="display: block; margin: auto;" /> --- # The issues tracker <img src="index_files/figure-html/onboarding-issues-tracker-1.png" width="1401" style="display: block; margin: auto;" /> --- # Proponer un paquete <img src="index_files/figure-html/onboarding-submission-1.png" width="1336" style="display: block; margin: auto;" /> --- # Proponer un paquete <img src="index_files/figure-html/onboarding-submission2-1.png" width="1401" style="display: block; margin: auto;" /> --- # Proponer un paquete <img src="index_files/figure-html/onboarding-submission3-1.png" width="1401" style="display: block; margin: auto;" /> --- # Proponer un paquete <img src="index_files/figure-html/onboarding-submission4-1.png" width="1401" style="display: block; margin: auto;" /> --- # No rechazos, pero... Solo aceptamos paquetes dedicados a ciertos temas. https://devguide.ropensci.org/policies.html#aims-and-scope -- * Nuestras categorías: _data retrieval, data extraction, database access, data munging, data deposition, reproducibility, geospatial data, text analysis_ -- * Aplicación en **ciencia** -- * Deben mejorar paquetes similares ya existentes -- Si tienen dudas, ¡_pre-submission inquiry_! --- # El procedimiento de revisión <img src="index_files/figure-html/onboarding-whole-thread-1.png" width="100" style="display: block; margin: auto;" /> --- # Chequeos de quienes editamos <img src="index_files/figure-html/onboarding-editor-1.png" width="350" style="display: block; margin: auto;" /> --- # El procedimiento de revisión Dos revisores. Discusión continua hasta la aprobación.  --- # ¡Extensión de nuestro sistema! 🎉 * Nueva orientación: software para estádistica * Mejor formación, documentación y herramientas para adopción del sistema Más información: https://ropensci.org/blog/2019/07/15/expanding-software-review/ --- # ¿Cómo participar en rOpenSci? https://ropensci.org/community * Envíen o revisen paquetes [ropensci.org/software-review](https://ropensci.org/software-review) * Participen en el desarrollo de paquetes. Guía: https://devguide.ropensci.org/contributingguide.html * Preguntar, discutir, demostrar uso [discuss.ropensci.org/](https://discuss.ropensci.org/) --- # Otros recursos de rOpenSci 💎 * Blogs [ropensci.org/blog](https://ropensci.org/blog) y [ropensci.org/technotes](https://ropensci.org/technotes) -- * Community calls (seminarios web) [ropensci.org/commcalls](https://ropensci.org/commcalls) -- * [github.com/ropensci](https://github.com/ropensci/) y [github.com/ropenscilabs](https://github.com/ropenscilabs/) para cosas más experimentales -- * Newsletter [news.ropensci.org](https://news.ropensci.org/) --- # rOpenSci Software Peer Review Revisar paquetes para una mejor ciencia https://tiny.cc/latinr19 ¡Gracias!  .small[[obpia30, Pixabay](https://pixabay.com/photos/cat-box-predator-650770/)]