Skip to content

Guidelines

Thank you for considering contributing to data7! We appreciate your interest and support. This documentation provides guidelines on how to contribute effectively to our project.

Issues

Issues are a valuable way to contribute. They can include bug reports, feature requests, and general questions or discussions. When creating or interacting with issues, please keep the following in mind:

1. Search for existing issues

Before creating a new issue, search the existing issues to see if your concern has already been raised. If you find a related issue, you can add your input or follow the discussion. Feel free to engage in discussions, offer help, or provide feedback on existing issues. Your input is valuable in shaping the project's future.

2. Creating a new issue

Use the provided issue template that fits the best to your concern. Provide as much information as possible when writing your issue. Your issue will be reviewed by a project maintainer and you may be offered to open a PR if you want to contribute to the code. If not, and if your issue is relevant, a contributor will apply the changes to the project. The issue will then be automatically closed when the PR is merged.

Issues will be closed by project maintainers if they are deemed invalid. You can always reopen an issue if you believe it hasn't been adequately addressed.

3. Code of conduct in discussion

  • Be respectful and considerate when participating in discussions.
  • Avoid using offensive language, and maintain a positive and collaborative tone.
  • Stay on topic and avoid derailing discussions.

Note

Before contributing, we invite you to read our complete code of conduct.

Discussions

Discussions in the Data7 repository are a place for open-ended conversations, questions, and general community interactions. Here's how to effectively use discussions:

1. Creating a discussion

  • Use a clear and concise title that summarizes the topic.
  • In the description, provide context and details regarding the discussion.
  • Use labels to categorize the discussion (e.g., "question," "general discussion," "announcements," etc.).

2. Participating in discussions

  • Engage in conversations respectfully, respecting others' opinions.
  • Avoid spamming or making off-topic comments.
  • Help answer questions when you can.

Note

Before contributing, we invite you to read our complete code of conduct.

Pull Requests (PR)

Contributing to Data7 through pull requests is a powerful way to advance the project. If you want to make changes or add new features, please follow these steps to submit a PR:

1. Fork the repository

Begin by forking the project's repository.

2. Clone the fork

Clone the forked repository to your local machine and change the directory to the project folder using the following commands (replace <your_fork> with your GitHub username):

git clone https://github.com/<your_fork>/data7.git
cd data7

3. Create a new branch

Create a new branch for your changes, ideally with a descriptive name:

git checkout -b your-new-feature

4. Make changes

Implement the changes or additions to the code, ensuring it follows coding and documentation standards.

For comprehensive guidance on starting your development journey with Data7 and preparing your pull request, please refer to our dedicated tutorials.

When committing your changes, please adhere to OpenFUN commit practices. Follow the low granularity commit splitting approach and use commit messages based on the Angular commit message guidelines.

5. Push changes

Push your branch to your GitHub repository:

git push origin feature/your-new-feature

6. Create a pull request

To initiate a Pull Request (PR), head to Data7 project's GitHub repository and click on New Pull Request.

Set your branch as the source and Data7 project's main branch as the target.

Provide a clear title for your PR and make use of the provided PR body template to document the changes made by your PR. This helps streamline the review process and maintain a well-documented project history.

7. Review and discussion

Data7 project maintainers will review your PR. Be prepared to make necessary changes or address any feedback. Patience during this process is appreciated.

8. Merge

Once your PR is approved, Data7 maintainers will merge your changes into the main project. Congratulations, you've successfully contributed to Data7! 🎉

Releases

Working on a new release

This project follows OpenFUN's standard process to release a new version. We invite you to read their handbook that describes it into details.