GBIF has released two technical documents for open peer review by its communities of practice:
- Guía de Uso Básico de OpenRefine para la limpieza de datos sobre biodiversidad, by Paula Zermoglio and John Wieczorek
- Current Best Practices for Generalizing Sensitive Species Occurrence Data, by Arthur Chapman
This paired release marks an important milestone for efforts started last year. Having long supported or produced technical documentation intermittently, GBIF committed in its 2019 work programme to coordinate a more coherent and dynamic approach that commissions subject-matter experts to prepare key guidance materials and engage GBIF communities of practice with oversight by an editorial panel.
The first two documents—colloquially, 'the OpenRefine guide' and 'Sensitive species best practices'—are now open for comment until Wednesday, 5 August 2020. Community members interested in participating as peer reviewers can gain valuable context from the overview of the digital documentation programme. They can then get specific instructions and expectations for offering their suggestions and improvements.
In short, to lend your voice and participate as a reviewer—on either one, both, and/or subsequent consultation periods—we ask community members to:
- Create a GitHub account.
- Read the documents—in this case, the OpenRefine guide and Sensitive species best practices
- If you see something, say something by creating or commenting on issues on GitHub (see video how-to
- Follow and support the conversation on the GBIF Community Forum
The systems and the processes used in GBIF's digital documentation programme are intended to be as transparent, open and self-policing as possible. Text and other content maintained in open GitHub repositories are published into HTML and PDF formats using an open-source publishing toolchain called AsciiDoctor. Support for translations is integrated via CrowdIn, which provides a free non-commercial licence that steadfastly supports the efforts of GBIF's vibrant volunteer translator community.
We encourage people interested in participating in these or future peer review processes to subscribe to the digital documentation mailing list.
Questions, comments and suggestions about this paired community review process or the digital documentation programme can be directed to firstname.lastname@example.org.