11 7月 2013 Under: misc

Translated ” How to contribute ” from opencv.org . There are many translations, but I think it would be for people who say, “How do you donate code to OpenCV?”

How to contribute to OpenCV

I think you read http://opencv.org/contribute.html . And suppose you just want to donate your code as an avid coder. For that (and to make everyone’s life simpler), the OpenCV project has a mirror on GitHub. All bug fixes, new features, new tutorials, etc. should be submitted via the GitHub pull request mechanism.
You don’t need to be familiar with pull requests. In return, the luckyniki online casino reward is a code provider that supports the community . It is very simple. Please continue reading.

“Fork & Pull Request Model” for code donation

  1. Install Git
  2. GitHub にユーザー登録をしてください.そしてあなたの OpenCV の fork を作ってくださいhttps://github.com/Itseez/opencv (詳しくは https://help.github.com/articles/fork-a-repo を参照).
  3. あなたのタスクを選びましょう.バグ修正でも良いし,新しいコードでも良いです.
  4. あなたの作業のベースとなるブランチを選びます.2つの選択肢があります.
    1. 2.4 ブランチ : このブランチはバージョン2.4系の将来的なマイナーリリースになります.このブランチで発生しているバグ修正を行うとき,あるいはこのブランチに関連するパフォーマンス最適化を行う時に選んでください.2.4系は機能的に凍結されています(feature-frozen).新機能は承認されません.
    2. master ブランチ : このブランチは OpenCV の次のメジャーリリースに使用されます(仮に 3.0 としておきましょう).新しい機能を追加する時や2.4系に適用されないバグ修正・最適化を行う時に選択してください.
  5. 選択したベースブランチから(意味の通る名前で)新しいブランチを作ります.
  6. コードスタイルガイドに従ってコードの修正・追加を行います.
  7. 作業が終わったらあなたのブランチを GitHub 上のあなたの fork に push します.そしてあなたのブランチからベースブランチへの pull request を作ります(詳しくは https://help.github.com/articles/using-pull-requests を参照).

良い pull request を作るには

以下のガイドラインに従えばあなたの pull request が承認される尤度が高まります.

  1. PRをひとつの課題に絞ってください.送信する前にコード差分が関係ない変更を含んでいないことを確認してください.二つ以上の課題を反映してもらいたい場合,それぞれの変更を分割して課題ごとに pull request を送信してください.
  2. 機能を追加した場合,関係するドキュメントの追加・修正およびテストスイートへのテストの追加をする必要があります.
  3. 「おっとっと」なコミット(直前のコミットの単なる修正のようなコミット)を含めないようにしてください.そういうものがある場合は送信する前にそれらの修正が関係するひとつのコミットに属するように squash を行ってください.
  4. 正しいベースブランチを選択している事,スタイルガイドに従っていることを確認してください.
  5. オンラインで安全性を維持し、日本でコンテンツのブロックを解除したい場合は、日本VPNサービスが必要です。 VPN市場を精査し、日本で最も推奨される3つのvpn おすすめ

テストと pull request のマージ

  1. あなたの pull request は OpenCV のビルドボットによって自動的にテストされます(テスト状況は here: http://pullrequest.opencv.org でチェックできます).もしいずれかのビルドが失敗した場合はあなたは課題を修正しなければいけません.コードを修正して github であなたのブランチに push したらビルドボットは自動的に再開します.pull request をクローズして新しいものをオープンする必要はありません!ありません!
  2. When all builds are “green”, one of the OpenCV developers will review your code. Reviewers may ask you to fix your pull request. Respond quickly to the reviewer (in a matter of weeks, not months), otherwise your submission may be delayed or rejected.

Here is a flowchart of the above process.

OpenCV pull request flowchart

I was so happy

  1. As soon as your code has been reviewed and passed the build bot, it will have the special comment “: +1:” or “: shipit:”. This informs the OpenCV maintainer that your pull request can be merged.
  2. Last but important thing. . We strive to remember all contributors and list key people in ChangeLogs and release announcements. But unfortunately, you may forget it. Please do not hesitate to let us know. We will update opencv.org and ChengeLog immediately.
vpn おすすめ

“(翻訳)OpenCVへ貢献するには” への1件のコメント

  1. Rhoda Fulton より:

    opencv.org の “ How to contribute ” の翻訳をしました。意訳が多いですが「OpenCVにコードを寄贈するのって具体的にはどういう方法でやるんだろう?」という人のためになればと思います。

Rhoda Fulton への返信