/**
 * 検索を実行します。
 *
 * @param query 検索クエリ
 * @return 検索結果
 * @throws SearchException 検索に失敗した場合
 */
public SearchResponse executeSearch(String query) throws SearchException {
    // 実装
}

実装コメント:

複雑なロジックには、日本語または英語でコメントを追加します。

// クエリの正規化（全角を半角に変換）
String normalizedQuery = QueryNormalizer.normalize(query);

クラスとメソッドの設計

単一責任の原則: 1 つのクラスは 1 つの責任のみを持つ
小さなメソッド: 1 つのメソッドは 1 つのことだけを行う
意味のある名前: クラス名、メソッド名は意図が明確になるように

例外処理

// 良い例: 適切な例外処理
try {
    executeSearch(query);
} catch (IOException e) {
    logger.error("検索中にエラーが発生しました", e);
    throw new SearchException("検索の実行に失敗しました", e);
}

// 避けるべき例: 空のcatchブロック
try {
    executeSearch(query);
} catch (IOException e) {
    // 何もしない
}

null の扱い

可能な限り null を返さない
Optional の使用を推奨
@Nullable アノテーションで null 可能性を明示

// 良い例
public Optional<User> findUser(String id) {
    return Optional.ofNullable(userMap.get(id));
}

// 使用例
findUser("123").ifPresent(user -> {
    // ユーザーが存在する場合の処理
});

テストの記述

すべての public メソッドにテストを書く
テストメソッド名は test で始める
Given-When-Then パターンを使用

@Test
public void testSearch() {
    // Given: テストの前提条件
    SearchService service = new SearchService();
    String query = "test";

    // When: テスト対象の実行
    SearchResponse response = service.search(query);

    // Then: 結果の検証
    assertNotNull(response);
    assertEquals(10, response.getDocuments().size());
}

コードレビューのガイドライン

プルリクエストのレビュープロセス

自動チェック: CI が自動的にビルドとテストを実行
コードレビュー: メンテナーがコードをレビュー
フィードバック: 必要に応じて修正依頼
承認: レビューが承認される
マージ: メンテナーが main ブランチにマージ

レビュー観点

レビューでは、以下の点を確認します：

機能性

要件を満たしているか
意図した通りに動作するか
エッジケースが考慮されているか

コード品質

コーディング規約に従っているか
読みやすく保守しやすいコードか
適切な抽象化がされているか

テスト

十分なテストが書かれているか
テストがパスするか
テストが意味のある検証をしているか

パフォーマンス

パフォーマンスへの影響はないか
リソースの使用は適切か

セキュリティ

セキュリティ上の問題はないか
入力検証は適切か

ドキュメント

必要なドキュメントが更新されているか
Javadoc が適切に書かれているか

レビューコメントへの対応

レビューコメントには、迅速かつ丁寧に対応します。

修正が必要な場合:

ご指摘ありがとうございます。修正しました。
[修正内容の簡単な説明]

議論が必要な場合:

ご意見ありがとうございます。
○○の理由で現在の実装としていますが、
△△という実装の方が良いでしょうか？

プルリクエストのベストプラクティス

PR の大きさ

小さく、レビューしやすい PR を心がける
1 つの PR には 1 つの論理的な変更を含める
大きな変更は複数の PR に分割

PR のタイトル

明確で説明的なタイトルを付けます：

feat: 検索結果のフィルタリング機能を追加
fix: クローラーのタイムアウト問題を修正
docs: API ドキュメントを更新

PR の説明

以下の情報を含めます：

変更内容: 何を変更したか
理由: なぜこの変更が必要か
テスト方法: どのようにテストしたか
スクリーンショット: UI 変更の場合
関連 Issue: Issue 番号（例: Closes #123）

## 変更内容
検索結果をファイルタイプでフィルタリングできる機能を追加しました。

## 理由
ユーザーから「特定のファイルタイプのみを検索したい」という
要望が多数寄せられていたため。

## テスト方法
1. 検索画面でファイルタイプフィルターを選択
2. 検索を実行
3. 選択したファイルタイプの結果のみが表示されることを確認

## 関連 Issue
Closes #123

コミットメッセージ

明確で説明的なコミットメッセージを書きます：

<type>: <subject>

<body>

<footer>

例:

feat: 検索フィルター機能を追加

ユーザーが検索結果をファイルタイプでフィルタリングできるようにしました。

- フィルターUI の追加
- バックエンドのフィルター処理を実装
- テストを追加

Closes #123

Draft PR の活用

作業中の PR は Draft PR として作成し、完成したら Ready for review に変更します。

1. PR 作成時に「Create draft pull request」を選択
2. 作業が完了したら「Ready for review」をクリック

コミュニティガイドライン

行動規範

Fess コミュニティでは、以下の行動規範を遵守します：

敬意を持つ: すべての人を尊重する
協力的である: 建設的なフィードバックを提供する
オープンである: 異なる視点や経験を歓迎する
礼儀正しい: 丁寧な言葉遣いを心がける

コミュニケーション

質問する場所:

GitHub Discussions: 一般的な質問や議論
Issue トラッカー: バグ報告や機能リクエスト
Fess Forum: 日本語フォーラム

質問の仕方:

具体的に質問する
試したことを説明する
エラーメッセージやログを含める
環境情報（OS、Java バージョンなど）を記載

回答の仕方:

丁寧に、親切に
具体的な解決策を提示
参考資料へのリンクを提供

感謝の表明

貢献に対しては、感謝の気持ちを表明します。小さな貢献でも、プロジェクトにとって価値があります。

よくある質問

Q: 初心者でも貢献できますか？

A: はい、歓迎します！good first issue ラベルの Issue から始めることをお勧めします。ドキュメントの改善も初心者に適した貢献です。

Q: プルリクエストはどのくらいでレビューされますか？

A: 通常、数日以内にレビューします。ただし、メンテナーのスケジュールによって前後する場合があります。

Q: プルリクエストが却下された場合は？

A: 却下の理由を確認し、必要に応じて修正して再提出できます。分からない点があれば、気軽に質問してください。

Q: コーディング規約に違反している場合は？

A: レビューで指摘されるので、修正すれば問題ありません。 Checkstyle を実行することで、事前にチェックできます。

Q: 大きな機能を追加したい場合は？

A: まず Issue を作成し、提案内容を議論することをお勧めします。事前に合意を得ることで、作業の無駄を避けられます。

Q: 日本語で質問しても良いですか？

A: はい、日本語でも英語でも構いません。 Fess は日本発のプロジェクトなので、日本語のサポートも充実しています。

貢献の種類別ガイド

ドキュメントの改善

ドキュメントのリポジトリをフォーク：
```
git clone https://github.com/codelibs/fess-docs.git
```
変更を加える
プルリクエストを作成

バグ報告

既存の Issue を検索して重複を確認
新しい Issue を作成
以下の情報を含める：
- バグの説明
- 再現手順
- 期待される動作
- 実際の動作
- 環境情報

機能リクエスト

Issue を作成
以下を説明：
- 機能の説明
- 背景と動機
- 提案する実装方法（任意）

コードレビュー

他の人のプルリクエストをレビューすることも貢献になります：

興味のある PR を見つける
コードを確認
建設的なフィードバックを提供

ライセンス

Fess は Apache License 2.0 のもとで公開されています。貢献されたコードも同じライセンスが適用されます。

プルリクエストを作成することで、あなたの貢献がこのライセンスのもとで公開されることに同意したものとみなされます。

謝辞

Fess プロジェクトへの貢献に感謝します！あなたの貢献が、Fess をより良いソフトウェアにします。

次のステップ

貢献の準備ができたら：

開発環境のセットアップで開発環境をセットアップ
開発ワークフローで開発フローを確認
GitHub で Issue を探す

参考資料

コミュニティリソース

GitHub: codelibs/fess
Discussions: GitHub Discussions
Forum: Fess Forum
Twitter: @codelibs
Website: fess.codelibs.org

メニュー

コントリビューションガイド

基本スタイル

命名規則

コメント

クラスとメソッドの設計

例外処理

null の扱い

テストの記述