Checklists

Open data

  • [ ] Ensure your data is in a simple, standard format or formats which is machine and human readable.

  • [ ] Check, reformat or create metadata to clearly describe what the data is, how it was collected, and any associated strengths/weaknesses to someone that finds it.

  • [ ] Identify a relevant, easily discoverable repository or repositories to host your data, and upload it there.

  • [ ] Assign your data a persistent identifier such as a DOI.

Open source software

  • [ ] Put your code in a freely accessible repository.

  • [ ] Include a licence granting others the right to use, copy and modify your work. You can use the software licenses section to help you pick the most appropriate licence for your project.

  • [ ] Include a readme file containing useful information about a project such as what it is, how to use/install it and how to run any tests.

  • [ ] If you want others to collaborate on the project include contribution guidelines.

Open hardware

  • [ ] Use open hardware where practical.

  • [ ] Make detailed documentation and designs for any hardware you develop openly available.

  • [ ] Include a licence granting others the right to use, copy and modify your work. You can use this website to help you pick the most appropriate licence for your project.

  • [ ] Include a readme file containing useful information about a project (for example, what it is and the materials used).

Open access

  • [ ] Publish your research in an open access journal.

  • [ ] Store a copy and/or preprint of your work in a freely accessible public repository.

Open notebooks

  • [ ] Keep notes in an Electronic Lab Notebook.

  • [ ] Make your notebooks publicly accessible online.

What to learn next

If you haven’t had a chance already, take a look at the chapter on version control, particularly the sections on GitHub in the latter half.

Further reading

This book on open science has a great deal of interesting information. For information specific to open source software this is a good place to look. For more information on DOIs and citing resources look here. If you want to take a look at an active open source project this textbook is one. The source can be found on GitHub here and for further details related to this project you can take a look at the project website.

Definitions/glossary

  • Citizen science: The involvement of members of the public in scientific research.

  • Contributing guidelines: Guidelines outlining how a person should go about contributing to an open source project.

  • Contributor: Someone that has contributed something (not necessarily code) to an open source project.

  • DOI: A widely used type of persistent identifier.

  • GitHub: An online code hosting and version control service. It has a great many features to aid collaboration between users, and hosts a large number of open source projects.

  • Maintainer: Contributors who are responsible for driving the vision and managing the organizational aspects of the project. They may also be authors and/or owners of the project.

  • Metadata: Data used to describe other data. For example (35, 33, 27, 30, 33) is data but the units (miles per hour) and the fact these are the speeds of cars on a certain stretch of road is metadata.

  • Open access publishing (gratis): The practice of making research publications available to anyone to read without charge.

  • Open access publishing (libre): Libre open access is gratis, meaning the research is available free of charge, but it goes further by granting users the right to copy, reuse, and remix the publication.

  • Open data: Data that is freely available online for reuse without bureaucratic or administrative barriers.

  • Open educational resource: Educational materials available online for anybody to use, remix and distribute.

  • Open notebook: The practise of making research notebooks openly available.

  • Open source software: Software which is available online for anybody to view, use, modify, and distribute.

  • Open source hardware: Hardware with documentation, designs, materials used, and other relevant information freely accessible and available

  • Persistent identifier: A long-lived method for identifying a resource that is unique, and widely understandable by a community.

  • Readme: A file which contains useful information about a project such as what it is, how to use/install it, how to test it, and how to contribute to it.

  • Repository: A long-lived place on the internet where resources (be they data, software, publications or anything else) can be stored and accessed.

  • Self-archive: To place your research output in a repository.

References specific for this chapter

  • 1. CC-BY 4.0

  • 2. CC 1.0

  • 3. Attribution + Noncommercial - CC-BY-NC

  • 4. Creative Commons Attribution Noncommercial Licence

  • 5. Attribution 4.0 International (CC BY 4.0)

  • 6. Attribution + Noncommercial - CC-BY-NC

  • 7. Creative Commons Attribution-NonCommercical

  • 8. CC Attribution 4.0 International Licence

  • 9. Creative Commons Attribution 4.0 International Licence

  • 10. Creative Commons Attribution-NonCommercical

  • 11. Creative Commons Attribution-NonCommercical

  • 12. Creative Commons

  • 13. Creative Commons Attribution 4.0 International Licence

  • 14. CC BY 3.0

  • 15. (CC BY 4.0)

  • 16. (CC BY 4.0)

  • 17. Attribution-ShareAlike 4.0 International

  • 18. Creative Commons Attribution 3.0 Licence

  • 19. CC0 1.0 Universal

  • 20. Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Licence

  • 21. Creative CommonsAttribution-NonCommercial-ShareAlike 2.0 UK: England & Wales (CC BY-NC-SA 2.0 UK)

  • 22. Creative Commons Attribution licence version 4.0

  • 23. CC BY-SA 4.0

  • 24. CC BY-SA 4.0

  • 25. Creative Commons Attribution-ShareAlike 4.0 International Licence

  • 26. CC BY 4.0

  • 27. Attribution 3.0 Unported (CC BY 3.0)

  • 28. CC BY-NC 2.0

  • 29. (CC BY 4.0)

Footnotes

  1. References by discipline: Agricultural studies (Kousha and Abdoli, 2010); Physics/astronomy (Gentil-Beccot et al., 2010; Harnad and Brody, 2004; Metcalfe, 2006); Medicine (Sahu et al., 2005; Xu et al., 2011); Computer science (Lawrence, 2001); Sociology/social sciences (Hajjem et al., 2006; Norris et al., 2008; Xu et al., 2011); Psychology (Hajjem et al., 2006); Political science (Hajjem et al., 2006; Antelman, 2004; Atchison and Bull, 2015); Management (Hajjem et al., 2006); Law (Donovan et al., 2015; Hajjem et al., 2006); Economics (Hajjem et al., 2006; McCabe and Snyder, 2015; Norris et al., 2008; Wohlrabe, 2014); Mathematics (Antelman, 2004; Davis and Fromerth, 2007; Norris et al., 2008); Health (Hajjem et al., 2006); Engineering (Antelman, 2004; Koler-Povh et al., 2014); Philosophy (Antelman, 2004); Education (Hajjem et al., 2006; Zawacki-Richter et al., 2010); Business (Hajjem et al., 2006; McCabe and Snyder, 2015); Communication studies (Zhang, 2006); Ecology (McCabe and Snyder, 2014; Norris et al., 2008); Biology (Frandsen, 2009b; Hajjem et al., 2006; McCabe and Snyder, 2014).