github-samples / github-samples/pets-workshop
1-hour workshop: Add concrete validation scenarios for the filter feature
まだ誰も着手していません。
- 主要言語
- Python
- スター
- 80
- フォーク
- 161
- 平均マージ
- 31分
- マージ済み PR(30日)
- 1
説明
Problem
Step 4 tells learners to review the generated code, open the site, run the existing Python tests, and confirm that the functionality works. The current unit tests cover the original dog-list response but do not prove generated breed or availability filtering. The workshop does not give learners concrete expected cases, so an implementation can appear complete while filters are ignored, combined incorrectly, or break pagination.
Because generated solutions vary, behavior-based validation is especially important here.
Suggested change
Add a short manual acceptance checklist and API examples to content/1-hour/4-add-feature.md. Keep it implementation-agnostic.
Acceptance criteria
- Learners verify breed-only filtering.
- Learners verify available-only filtering.
- Learners verify both filters together.
- Changing a control automatically refreshes results as required.
- Clearing filters restores the unfiltered list.
- No-result behavior and pagination/filter interaction are checked.
- The documented Python test command continues to pass.
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
content/1-hour/4-add-feature.md を開き、Step 4 と既存の Python テストコマンドを確認します。各フィルターの組み合わせ、更新時の動作、フィルターのクリア、結果がない場合、ページネーションについて、実装に依存しない手動チェックと API の例を追加します。すべての受け入れケースが文書化され、既存の Python テストが引き続きパスすれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- python
- 領域
- documentation, testing-qa
- issue の種類
- ドキュメント
- 難易度
- 1/5
- 見積もり時間
- 1〜3時間
- 活発さ
- 活発
- 明瞭さ
- 明確に書かれている
- 初心者へのやさしさ
- 92/100