Contributing to floWeaver
Thanks for your interest in contributing to floWeaver!
floWeaver is an open Python framework to help exchange and analyse flow data and visualise it using Sankey diagrams. There are lots of ways you can get involved and help, from sharing examples of work done using it, providing feedback, improving the documentation and identifying and fixing bugs in the code. See the "what shall I do?!" board for examples!
This document is a set of guidelines for contributing to floWeaver on GitHub. These are guidelines, not rules. This guide is meant to make it easy for you to get involved.
What we're working on
Browse some good first bugs arranged by types of contribution on the "what shall I do?!" board or see the full list of good first bugs to get started! If you have any questions please get in touch (see below).
The project is split between 3 repositories:
- The floWeaver Python package (this repository): data aggregation, preparation, conversion
- The d3-sankey-diagram: layout, SVG rendering of Sankey diagrams
- The ipysankeywidget: embed d3-sankey-diagram within Jupyter notebooks
How to submit changes
Once you've identified one of the issues above that you feel you can contribute to, you're ready to make a change to the project repository!
- Fork this repository. This makes your own version of this project you can edit and use.
- Make your changes! You can do this in the GitHub interface on your own local machine. Once you're happy with your changes...
- Submit a pull request. This opens a discussion around your project and lets the project lead know you are proposing changes.
First time contributing to open source? Check out this free series, How to Contribute to an Open Source Project on GitHub. If you have any problems, get in touch (see below).
Reporting bugs and share how you find using floWeaver
We want to know if you find a bug, have trouble using floWeaver, but also if you use it successfully! Please file bugs, requests or questions in our issue tracker, including:
- sharing examples of how you are using floWeaver,
- suggestions for improving the documentation,
- examples of things that are more difficult than they should be or don't work