このページを改善する

プルリクエストのマージ

このガイドはメンテナー向けです。 これらの特別な人々は、Jekyll の 1 つ以上のリポジトリへの書き込みアクセス権を持ち、他の人々の貢献をマージするのを手伝います。 ここに書かれていることは興味深いかもしれませんが、間違いなくすべての人向けではありません。

コードレビュー

すべてのプルリクエストはコードレビューの対象となる必要があります。 コードレビューは、優れたエンジニアリングチームの基本価値です。 正当性の検証を提供することに加えて、コミュニティ意識を高め、他のメンテナーにコードベースのすべての部分を理解させます。 要するに、コードレビューは健全なオープンソースプロジェクトにとって非常に重要です。

マージする前に、プルリクエストのレビューに関するガイドをお読みください。 特に、変更がコードの場合にはテストが必要であり、少なくとも 2 人のメンテナーが OK を出す必要があります。

マージ

プルリクエストのマージに使用する便利な小さなボットがあります。 2 つの理由から GitHub.com インターフェースは使用しません。

  1. モバイルでは何も変更できません (タイトル、ラベルなど)
  2. 各リリースの History.markdown ファイルに一貫した記録を残したいと考えています

プルリクエストをマージするには、貢献者に感謝するコメントを残し、特別なマージリクエストを追加します

Thank you very much for your contribution. Folks like you make this project and community strong. :heart:

@jekyllbot: merge +dev

マージリクエストは次の 3 つの要素で構成されています

  1. @jekyllbot: – これは、ボットがコマンドを処理するときに探すプレフィックスです
  2. merge – コマンド
  3. +dev – 変更が属するカテゴリ。

カテゴリは History.markdown ファイルの見出しと一致し、次のとおりです。

  1. メジャー機能強化 (+major) – メジャーバージョンアップ (v3 ~> v4) を必要とするコードへのメジャーアップデートまたは破壊的な変更
  2. マイナー機能強化 (+minor) – マイナーバージョンアップ (v3.1 ~> v3.2) を必要とするマイナーアップデート (ラベル feature または enhancement を持つ)
  3. バグ修正 (+bug) – 機能を追加または変更しないコードの修正で、パッチバージョンアップ (v3.1.0 ~> v3.1.1) を必要とするもの
  4. ドキュメント (+doc) - docs/_docs/ にあるドキュメントへの変更
  5. サイトの機能強化 (+site) – https://jekyll.dokyumento.jp のソースへの変更で、docs/ にあります
  6. 開発修正 (+dev) – テストの修正や内部依存関係の更新など、ユーザーに影響する機能やドキュメントに影響を与えない変更
  7. 前方移植 (+port) — master にプルされた以前のバージョンの Jekyll に適用されたバグ修正 (例: 3-1-stable から master への cherry-pick コミット)

@jekyllbot がプルリクエストをマージすると、次の 3 つが表示されます

  1. マージの成功
  2. 必要なカテゴリのラベルがまだ適用されていない場合は、ラベルの追加
  3. 変更に関するメモを追加する History.markdown ファイルへのコミット

カテゴリを忘れても問題ありません。 後で戻って、行を適切なカテゴリヘッダーに移動できます。 カテゴリは常に jekyll/jekyll で必要ですが、多くのプラグインには変更が少なすぎて、変更ログカテゴリを必要としません。

歓喜

完了しました! 公式 Jekyll プロジェクトのメンテナーになっていただきありがとうございます。 あなたの仕事は、毎日 Jekyll を頼りにしている何千人ものユーザーにとって非常に重要です。 :heart: