概要
Kodus の設定は 3 つのレベルで機能します：グローバル、リポジトリ、ディレクトリ。最も具体的なレベルが優先されます：ディレクトリ > リポジトリ > グローバル
仕組み
フィールドはデフォルトで親レベルから継承されます。グローバルでフィールドを変更すると、オーバーライドのないすべてのリポジトリとディレクトリが自動的に更新されます。オーバーライドはフィールドごとです。1 つのフィールドをオーバーライドして他のすべてを継承することができます。
アプリでの操作
- レベルの切り替え： サイドバーの Code review グループ上部にあるスコープピッカーには、Global（“applies to every repository”）、続いて独自の設定を持つ各リポジトリが、そのディレクトリをインデントした形で一覧表示されます。スコープを切り替えても同じページ（General、What to review、Kody Rules、What Kody writes）にとどまります。
- レベルの追加： スコープピッカーで Add repository configuration を選択します。Create repository settings ダイアログで Select the target repository と、必要に応じて Select the target directories を指定し、Create settings をクリックします。ディレクトリレベルの設定を参照してください。
- オーバーライドの確認： サイドバーのスコープやページの横にある数値のピルは、そのレベルでオーバーライドされた設定の数を示します（“N settings overridden at this level”）。ページ上では、オーバーライドされた各フィールドに Overridden バッジが表示され、その元に戻すボタンでフィールドを継承に戻せます。
- レベルの削除： スコープピッカーの横にある ⋯ メニューに Delete configuration（ディレクトリスコープでは Edit directories も）があります。
例
- グローバルの変更が伝播する
- リポジトリのオーバーライド
- 継承に戻す
グローバルで Minimum severity to post（What to review 上）を変更します。オーバーライドのないすべてのリポジトリとディレクトリが自動的に更新されます。オーバーライドされたものは変わりません。
ベストプラクティス
- 強力なデフォルトでグローバルから始める
- そのリポジトリ/ディレクトリに特定のニーズがある場合のみオーバーライドする
よくある質問
グローバルで何かを変更すると、ローカルの調整が壊れますか？
グローバルで何かを変更すると、ローカルの調整が壊れますか？
いいえ。ローカルのオーバーライドは変更されません。
1 つのフィールドだけをオーバーライドして残りを継承できますか？
1 つのフィールドだけをオーバーライドして残りを継承できますか？
はい。オーバーライドはフィールドごとです。
ディレクトリはリポジトリとグローバルのどちらから継承しますか？
ディレクトリはリポジトリとグローバルのどちらから継承しますか？
まずリポジトリから。リポジトリにそのフィールドのオーバーライドがない場合は、グローバルから継承します。