Contributing Guidelines
Thank you for considering contributing to the BigDataViewer open source project! By contributing, you are helping to improve and grow the software for everyone in the community. We appreciate your time and effort.
Table of Contents
Governance
Founder: Tobias Pietzsch Lead: Tobias Pietzsch Maintainers: Tobias Pietzsch, Stephan Preibisch
And the team role definitions: Founder - Created the project. Does not imply any current participation or responsibility. Lead - Has decision-making authority: timing of releases, inclusion of features, etc. Maintainer - Merges patch submissions. Cuts releases.
Code of Conduct
Before contributing, please review our Code of Conduct. We aim to foster an inclusive and respectful community where everyone feels safe to participate.
Getting Started
Making Contributions
Please see the general guidlines on how to contribute to an existing plugin or library: https://imagej.net/develop/improving-the-code
Creating Issues
If you find a bug, have a feature request, or encounter any issues, please search our BDV issue tracker to see if it has already been reported. If not, feel free to create a new issue and provide as much detail as possible.
Working on Issues
If you want to work on an existing issue, please follow these steps:
- Comment on the issue to express your interest in working on it.
- Fork the repository and create a new branch for your work.
- Make your changes and commit them with clear commit messages.
- Ensure your code follows our Code Guidelines.
- Update the documentation if necessary.
- Run tests to ensure your changes don’t break existing functionality.
Submitting Pull Requests
- Push your changes to your forked repository.
- Create a pull request (PR) from your branch to our main repository’s appropriate branch.
- Provide a detailed description of your changes in the PR.
- Reference any related issues using keywords (e.g., “Closes #123”).
- Be ready to address feedback and make necessary changes.
Code Guidelines
- Use consistent code formatting and style throughout the project.
- Follow naming conventions for variables, functions, and classes.
- Ensure your code is well-documented.
- Write meaningful commit messages.
Testing
Explain how to run tests and provide information about the testing framework used.
Documentation
If your changes introduce new features or modify existing ones, please update the documentation accordingly. This includes code comments, README files, and any additional documentation files.
Community
Join in our community discussions on imagesc.zulipchat.com for discussions. For more general questions of broad interest and announcements the image.sc forum can be used advantageously. We welcome your feedback and ideas.
License
By contributing to this project, you agree that your contributions will be licensed under the project’s license BigDataViewer license a BSD 2-Clause “Simplified” License. If you’re not comfortable with this, please consider refrain from contributing.