|
| 1 | +# Good First Issues — seed list |
| 2 | + |
| 3 | +18 small, well-scoped tasks that make good first PRs. Each has clear acceptance |
| 4 | +criteria so a newcomer can finish in one sitting. This is the **fork-funnel**: label |
| 5 | +them `good first issue`, and beginners farming their GitHub contributions will fork, |
| 6 | +fix, PR, and star. |
| 7 | + |
| 8 | +To create them all as real GitHub issues, run `bash scripts/seed_issues.sh` (below), |
| 9 | +or copy each block into a new issue by hand. |
| 10 | + |
| 11 | +| # | Title | Area | Acceptance | |
| 12 | +|---|-------|------|-----------| |
| 13 | +| 1 | Add a Graphic Design category preset | presets | `benchmarks.sample.json` gains a graphic-design segment; a test asserts it loads | |
| 14 | +| 2 | Add a Video & Animation category preset | presets | new segment + test | |
| 15 | +| 3 | Add a Writing & Translation category preset | presets | new segment + test | |
| 16 | +| 4 | Add `--json` output flag to `build_catalog.py` | feature | emits the catalog as JSON; test checks schema | |
| 17 | +| 5 | Add a `--csv` competitor export to `analyze_pricing.py` | feature | writes rows to CSV; test on a fixture | |
| 18 | +| 6 | Translate `FIVERR_PASTE_SHEET.md` template to Spanish | i18n | `FIVERR_PASTE_SHEET.es.md` mirrors structure | |
| 19 | +| 7 | Translate the paste sheet to Portuguese | i18n | `.pt-BR.md` variant | |
| 20 | +| 8 | Add dark-mode CSS to the catalog HTML | ui | `prefers-color-scheme: dark` styles; screenshot in PR | |
| 21 | +| 9 | Add a "copy title" button to each gig card | ui | button copies the title; no framework, vanilla JS | |
| 22 | +| 10 | Validate tag count ≤ 5 in `build_catalog.py` | validation | warns/flags gigs with >5 tags; test | |
| 23 | +| 11 | Validate title ≤ 80 chars | validation | flag over-length titles; test | |
| 24 | +| 12 | Add a `--seller-name` CLI override | feature | overrides `seller.name` from config; test | |
| 25 | +| 13 | Document each script's JSON I/O in `docs/` | docs | one markdown page per script | |
| 26 | +| 14 | Add example `gig-config.json` for a designer | examples | realistic sample under `examples/` | |
| 27 | +| 15 | Add a `make test` / `just test` shortcut | dx | one-command test run; README note | |
| 28 | +| 16 | Improve the empty-state when a keyword has no data | ux | catalog renders an honest "no data" card; test | |
| 29 | +| 17 | Add `pre-commit` config running `pytest` | dx | `.pre-commit-config.yaml` + docs | |
| 30 | +| 18 | Add alt-text lint for README images | a11y | script flags `<img>` missing `alt`; CI-friendly | |
| 31 | + |
| 32 | +## `scripts/seed_issues.sh` |
| 33 | + |
| 34 | +```bash |
| 35 | +#!/usr/bin/env bash |
| 36 | +# Creates the labels + issues above. Requires: gh auth login already done. |
| 37 | +set -e |
| 38 | +REPO="Ahad690/fiverr-gig-optimizer" |
| 39 | +gh label create "good first issue" --repo "$REPO" --color 7057ff --force 2>/dev/null || true |
| 40 | +gh label create "hacktoberfest" --repo "$REPO" --color ff6b35 --force 2>/dev/null || true |
| 41 | + |
| 42 | +create() { gh issue create --repo "$REPO" --label "good first issue" --title "$1" --body "$2"; } |
| 43 | + |
| 44 | +create "Add a Graphic Design category preset" "Add a graphic-design segment to \`benchmarks.sample.json\` and a test asserting it loads. See CONTRIBUTING.md. Honesty rule: no invented numbers — presets carry provenance." |
| 45 | +create "Add \`--json\` output flag to build_catalog.py" "Emit the catalog as JSON alongside HTML. Add a test checking the schema. Keep pytest green." |
| 46 | +# ... (repeat for issues 2-18; see table above) |
| 47 | +echo "Done. Review the created issues before sharing." |
| 48 | +``` |
| 49 | + |
| 50 | +> **Note:** creating 18 public issues is outward-facing and hard to undo. Review the |
| 51 | +> list, then run the script (or ask the maintainer to). Start with 5–8 if unsure. |
0 commit comments