Playbook
Guides
Practice-facility hub for analysts and operators who need repeatable NBA data workflows.
Guides
Use this section like the practice facility for nbadb: pick the workflow that matches the job in front of you, run the opening drill, and then branch into deeper schema, lineage, or troubleshooting pages only when the possession demands it.
Start with the guide that matches the question you need answered today. The best route is usually the shortest one that gets you to a working query, a clean rerun, or a confident handoff.
Pick your first drill
| If you need to… | Start here | Finish on… |
|---|---|---|
| get a new analyst productive quickly | Role-Based Onboarding Hub | one follow-up guide matched to their job |
| answer a basketball question fast | Analytics Quickstart | a reusable DuckDB, Polars, or shot-chart pattern |
| run or recover the pipeline | Daily Updates | a clean rerun or a narrower failure lane |
| debug a broken artifact or command | Troubleshooting Playbook | the exact report, JSON artifact, or command that explains the miss |
Practice lanes
Opening drill
Start with Role-Based Onboarding Hub when you need the fastest route by role, or jump straight to Analytics Quickstart if the goal is a first working query in minutes.
Skill work
Use DuckDB Query Examples, Player Comparison, Shot Chart Analysis, and Parquet Usage when the possession has already narrowed to a specific analysis pattern.
Creative systems
Reach for Visual Asset Prompt Pack when you need AI-generated hero art, Open Graph cards, icons, or texture plates that still match the court-first nbadb identity.
Game-day operations
Keep Daily Updates open for recurring refresh work, and move to Kaggle Setup when the conversation shifts from local data shape to packaging and distribution.
Film room and recovery
Use Troubleshooting Playbook for artifact-first debugging, then read Strategic Shift Rollout when the problem is really about sequencing, migration, or stakeholder alignment.
Guide roster
| Guide | Best for | Typical next stop |
|---|---|---|
| Role-Based Onboarding Hub | Choosing the right first page and command by persona | Installation, CLI Reference, or Schema Reference |
| Analytics Quickstart | Getting from download to first answer | DuckDB Query Examples or Player Comparison |
| DuckDB Query Examples | SQL-first exploration | Schema Reference or Table Lineage |
| Player Comparison | Head-to-head player reads | Shot Chart Analysis |
| Shot Chart Analysis | Court-map and zone work | Column Lineage |
| Visual Asset Prompt Pack | Generating on-brand hero art, OG cards, icons, and background plates | homepage redesigns, social sharing, and docs art refreshes |
| Parquet Usage | DataFrame-first workflows | Schema Reference |
| Daily Updates | Recurring pipeline refreshes | Troubleshooting Playbook |
| Kaggle Setup | Publish and delivery flow | Architecture |
| Troubleshooting Playbook | Narrow recovery loops for failures | exact health artifacts, coverage reports, or docs-autogen commands |
| Strategic Shift Rollout | Change management and rollout sequencing | Architecture or Pipeline Flow |
How to use this section well
- Start on the guide that matches the current job, not the whole platform.
- Borrow a working pattern before you invent a new one.
- Drop into Schema Reference or Lineage only when the workflow turns into a contract or dependency question.
- End on the narrowest reusable artifact: a query, command, report, or checklist you can rerun on the next possession.
Keep moving
Stay in the same possession
Keep the mental model warm with adjacent pages, section hubs, and search-friendly routes into the same topic cluster.
Analytics Quickstart
Land quick wins fast and move from setup to analysis with intent.
Shot Chart Analysis
Lean into basketball-native visual storytelling on one of the best-fit pages.
Visual Asset Prompt Pack
Generate hero art, OG cards, icons, and texture systems without losing the docs identity.