Open-source Software

Ways to contribute¶

One of the first things that come to mind contributing to a project is to add code or fix bugs or any other way that involves changing code. While improvements are a center element to advance a project, there are other ways to get involved without needing to know much about programming, or the project code structure itself:

1. Report bugs
2. Add documentation
3. Help others using the project
4. Start on issues marked as ‘good first issue’
5. Attend a meeting for the project (virtual or in-person)

Open source How-To guides¶

Here are some community/open-source resources for learning more about open-source software, tools and tricks for [collaborative] development, and open science in general.

• The Turing Way
  • Keywords: GitHub; tutorials; guides; reproducible; collaborative; data science; contribute; development; open-source; git
  • “The Turing Way is an open source community-driven guide to reproducible, ethical, inclusive and collaborative data science.”
  • “Our goal is to provide all the information that data scientists in academia, industry, government and the third sector need at the start of their projects to ensure that they are easy to reproduce and reuse at the end.”
• GitHub Open Source Guides
  • Keywords: guides; tutorials; development

Elements of an open source project¶

Below, a few elements to get started. This sample is not even scratching the surface for the breadth and depth of options and are meant to kick things off:

1. README file

   Let people know what your project is about. This can also include on how to setup your project for development.

2. Contributions guide

   Give some instructions on how people can get involved with your project. GitHub healthy contributions guide

3. Tests

   Software testing adds a quality check to your project and ensures that future changes to the code do not break existing functionality.

   Packages/Documentation:

   • PyTest
   • Python Hitchhiker’s guide
   • Travis CI
   • GitHub Actions

4. Documentation

   New users or interested people to your project benefit from a well documented project and how to use it.

   Platforms/Libraries:

   • Read the Docs
   • Sphinx
   • ReStructred Text (rst)

5. Code Conventions

   At some stage of your project, you might want to establish some conventions for coding style, so you have consistency across the library.

   References/Services:

   • Pep8
   • Code Climate
   • Code Coverage

6. License

   The legal aspect for your project. Good source to figure out the right license: https://tldrlegal.com/

7. Publishing your package

   For people to be able to install your package from the command line via pip or conda

   • PyPi
   • Conda Forge

8. Organize your community

   Platforms:

   • Slack
   • Discourse

Software development environments¶

Outside a Jupyter environment, you can also manage your package or code using these development environments or sometimes also referred to as IDE’s (Integrated Development Environments)

Some choices:

• Visual Studio
  • Has integration options with Jupyter Notebooks
• IntelliJ - PyCharm
  • Jupyter Notebook support
  • They have free academic and open source project product licenses
• Git’s Atom editor
  • Jupyter Notebook plugin

Git Learning Resources¶

• Learn git interactively!
  • Keywords: git; interactive
  • A great hands on tutorial for playing with git on a “virtual” repository. Practice here before applying to your actual software!