# コントリビュートする

# Playground.vue

Playground ファイルは、Vuetifyの開発に使用されるクリーンルームであり、フレームワーク内の変更を繰り返すために推奨される方法です。

<template>
  <v-container>
    <!--  -->
  </v-container>
</template>

<script>
  export default {
    data: () => ({
      //
    }),
  }
</script>

Vuetify開発に使用される App.vue ファイルは、 packages/vuetify/dev にあります。 v-app と v-main コンポーネントとローカルの Playground.vue ファイルが含まれています。

# ベースブランチの選択

開発を始める前に、変更のベースとなるブランチを知っておく必要があります。 疑問がある場合は master を使用してください。master への変更は通常、rebaseせずに別のブランチにマージすることができます。

# 目的のブランチに切り替える
git switch master

# upstreamの変更をプル
git pull

# 作業用に新しいブランチを作成する
git switch --create fix/1234-some-issue

ガイドラインに従って変更をコミットし、git push -u forkでブランチをフォークにプッシュし、テンプレートに従って Vuetify リポジトリ上でプルリクエストを開きます。

# ドキュメント用 - 言語

en 以外の言語に関連するドキュメントの変更については、PRを受け付けていません 。 en 以外の言語の変更はすべてCrowdin プロジェクト を通して提出してください。 次の2つの方法のいずれかで翻訳を手伝うことができます:

• ドキュメントサイトから直接コンテキスト内の翻訳サービスを使用します。 ドキュメントの言語ドロップダウンで Help Translate を選択するだけです。
• 直接 Crowdin プロジェクト を介して翻訳する。

注: 翻訳の少なくとも50%が完了するまでは、文書サイトの言語ドロップダウンに言語は追加されません。

# はじめましょう

Vuetify に主要な機能を追加するには、あなたの RFC を .mdファイルとしてこのリポジトリにマージする必要があります。 開始方法のガイドは次のとおりです:

• Vuetifyの RFC リポジトリ https://github.com/vuetifyjs/rfcs をフォークします。

• 0000-template.md を active-rfcs/0000-my-feature.md にコピー (ここでの my-feature は説明用です。 RFC番号はまだ割り当てないでください)。

• RFCを記入します。 詳細に注意を払ってください。

  !!crwd_CB_78_BC_dwrc!!

• プルリクエストを送信します。 RFC プルリクエストとして、より大きなコミュニティからのデザインフィードバックを受け取ることになるので、それに応じて修正する準備をしておく必要があります。 新しい RFC プルリクエストは、 Pending ステージで保留中として開始されます。

• コンセンサスを形成し、フィードバックを統合します。 幅広いサポートを受けている RFC は、コメントを受け取らない RFC よりも進展する可能性がはるかに高くなります。

• 最終的には、コアチームが、そのRFCがVuetifyに含めるべき候補であるかどうかを決定します。

• RFC は、コア チームやコミュニティからのフィードバックに基づいて修正することができます。 大幅な変更は、新たな 最終コメント 期間のトリガーとなる場合があります。

• RFCは、公開討論の終了後、リジェクト理由を要約したコメントが作成され、リジェクトされる場合があります。 コアチームメンバーは、RFCに関連付けられたプルリクエストをクローズします。RFCはRejectedステージに入ります。

• RFC は、_最終コメント_期間が終了した時点で受理されることがあります。 コアチームメンバーは、RFCに関連付けられたプルリクエストをマージします。その時点で、RFCはActiveステージに入ります。

RFC がマージされると、対応する機能が Vuetify リポジトリ内に実装されます。 次の メジャー または マイナー リリースの一部になります。 一度リリースされると、RFC は Released ステージに入り、ロックされます。

RFC についての詳細は公式リポジトリを参照してください: https://github.com/vuetifyjs/rfcs

# 一般的なルール

• コミットメッセージには件名が必要で、本文が含まれている場合があります。 これらは空白行で区切る必要があります。

• 件名は 60 文字以内でなければなりません。

• 件名は命令法で書く必要があります（fix, not fixed / fixes etc.）

• 本文のコピーには、解決されたすべての問題への参照が含まれている必要があります:

  docs(sass-variables): fix broken link to api
  
  resolves #3219
  resolves #3254
  

• 本文のコピーは72文字で折り返さなければなりません。

• 本文のコピーには、何を、なぜ、どのようにではなく、説明のみを含める必要があります。 後者はドキュメントと実装に属します。

# コミットの種類

angular プリセットで使用される commit types のリストは以下のとおりです:

• feat: 新機能や機能性をもたらすコミット。 下位互換の機能は次の MINOR でリリースされますが、破壊的変更は次の MAJOR でリリースされます。 破壊的変更を伴うコミットの本文は、 BREAKING CHANGEで始まる必要があります。 次に、API の変更方法を説明します。
• fix: vuetifyのコードベース内のバグ修正を提供するコミット。
• docs: ドキュメントに更新を提供するコミット。
• style: コードの実行方法に影響を与えないコミット、これらは単にフォーマットの変更です。
• refactor: バグの修正も機能の追加も行わないコミット。
• perf: パフォーマンスを向上させるコミット。
• test: 不足しているテストまたは既存のテストを修正するコミット。
• chore: src ファイルやテストファイルを変更しないその他のコミット。
• revert: 以前のコミットを元に戻すコミット。

# Commitizen

Vuetifyチーム は、すべてのリポジトリコミットに対して commitizen を使用します。 通常のコミット機能の変更を最小限に抑えて、読みやすく整理されたコミットが可能になります。 Commitizenはセマンティック・バージョン管理のための流動的なインターフェースを提供し、 リリースノートの作成を容易にします。

始めるには、ターミナルで以下のコマンドを実行することで yarnを使用して commitizen パッケージをグローバルにインストール します。

# commitizenと従来のchangelogアダプターをインストールします
yarn global add commitizen cz-conventional-changelog

# 次に、どのアダプタをグローバルに使用するかを
# commitizenに伝える.czrcファイルを作成します。
echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc

完了したら、 git commit の代わりに、ターミナルで git cz コマンドを実行します。 ここから、コミット メッセージを作成するために使用される一連のプロンプトが表示されます。 詳細については、 コミット のガイドラインをご覧ください。