Skip to content

Latest commit

 

History

History
32 lines (27 loc) · 1.89 KB

CONTRIBUTING.md

File metadata and controls

32 lines (27 loc) · 1.89 KB

Thanks for considering to contribute to the Modelica Standard Library.

Contributing can be done by either filing an issue or by contributing code.

When filing an issue, please include all information necessary to reproduce, and state what package is affected.

The workflow for contributing code depends on whether you are a collaborator with push rights, or an outside collaborator.

The workflow for outside collaborators is usually as follows:

  1. Fork the repository to your account by using the Fork button.
  2. Clone the forked repository to your computer.
  3. Create a new topic branch and give it a meaningful name, like, e.g., issue2161-fix-formula.
  4. Do your code changes and commit them, one change per commit. Single commits can be copied to other branches. Multiple commits can be squashed into one, but splitting is difficult.
  5. Once you are done, push your branch to your fork.
  6. Go to the upstream ModelicaStandardLibrary repository and submit a Pull Request (PR).
    • If the PR is related to a certain issue, reference it by its number like this: #2161.
    • Once a pull request is opened, you can discuss and review the potential changes with collaborators and add follow-up commits before the changes are merged into the repository.
    • If you have not already signed the Modelica Association Contributor License Agreement (CLA) you need to do so one-time. You can sign the CLA electronically using the CLA Assistant service and your GitHub account. There is no need to scan and send any documents by mail.
  7. Update your branch with the requested changes. If necessary, merge the latest master into your branch and solve all merge conflicts in your branch.