Watch 340 Star 731 Fork 539

GVPMindSpore / mindsporePythonApache-2.0

Join us
Explore and code with more than 5 million developers,Free private repositories !:)
Sign up
MindSpore is a new open source deep learning training/inference framework that could be used for mobile, edge and cloud scenarios. spread retract

  • C++ 53.4%
  • Python 44.1%
  • Cuda 0.9%
  • CMake 0.7%
  • Shell 0.7%
  • Other 0.2%
Clone or download 5.07 KB
Copy Edit Web IDE Raw Blame History
leonwanghui authored 2020-04-09 15:58 . Update setuptool info

MindSpore contributing guidelines

Contributor License Agreement

It's required to sign CLA before your first code submission to MindSpore community.

For individual contributor, please refer to ICLA online document for the detailed information.

Getting Started

Contribution Workflow

Code style

Please follow this style to make MindSpore easy to review, maintain and develop.

Fork-Pull development model

  • Fork MindSpore repository

    Before submitting code to MindSpore project, please make sure that this project have been forked to your own repository. It means that there will be parallel development between MindSpore repository and your own repository, so be careful to avoid the inconsistency between them.

  • Clone the remote repository

    If you want to download the code to the local machine, git is the best way:

    # For GitHub
    git clone{insert_your_forked_repo}/mindspore.git
    git remote add upstream
    # For Gitee
    git clone{insert_your_forked_repo}/mindspore.git
    git remote add upstream
  • Develop code locally

    To avoid inconsistency between multiple branches, checking out to a new branch is SUGGESTED:

    git checkout -b {new_branch_name} origin/master

    Then you can change the code arbitrarily.

  • Push the code to the remote repository

    After updating the code, you should push the update in the formal way:

    git add .
    git status # Check the update status
    git commit -m "Your commit title"
    git commit -s --amend #Add the concrete description of your commit
    git push origin {new_branch_name}
  • Pull a request to MindSpore repository

    In the last step, your need to pull a compare request between your new branch and MindSpore master branch. After finishing the pull request, the Jenkins CI will be automatically set up for building test.

Report issues

A great way to contribute to the project is to send a detailed report when you encounter an issue. We always appreciate a well-written, thorough bug report, and will thank you for it!

When reporting issues, refer to this format:

  • What version of env (mindspore, os, python etc) are you using?
  • What happened?
  • What you expected to happen?
  • How to reproduce it?(as minimally and precisely as possible)
  • Special notes for your reviewers?

Issues advisory:

  • If you find an unclosed issue, which is exactly what you are going to solve, please put some comments on that issue to tell others you would be in charge of it.
  • If an issue is opened for a while, it's recommended for contributors to precheck before working on solving that issue.
  • If you resolve an issue which is reported by yourself, it's also required to let others know before closing that issue.

Propose PRs

  • Raise your idea as an issue on GitHub or Gitee
  • If it is a new feature that needs lots of design details, a design proposal should also be submitted.
  • After reaching consensus in the issue discussions and design proposal reviews, complete the development on the forked repo and submit a PR.
  • None of PRs is not permitted until it receives 2+ LGTM from approvers. Please NOTICE that approver is NOT allowed to add LGTM on his own PR.
  • After PR is sufficiently discussed, it will get merged, abandoned or rejected depending on the outcome of the discussion.

PRs advisory:

  • Any irrelevant changes should be avoided.
  • Make sure your commit history being ordered.
  • Always keep your branch up with the master branch.
  • For bug-fix PRs, make sure all related issues being linked.

Help Search

182353 aa51c838 1899542 205747 347fc4a1 1899542