Skip to content

expand BBQ theory knowledge graph - #1

Merged
StevenGGA merged 1 commit into
mainfrom
agent/bbq-theory-knowledge-graph
Aug 2, 2026
Merged

expand BBQ theory knowledge graph#1
StevenGGA merged 1 commit into
mainfrom
agent/bbq-theory-knowledge-graph

Conversation

@StevenGGA

Copy link
Copy Markdown
Owner

What changed

  • Expanded the encyclopedia from 38 to 520 contextual internal links.
  • Added complete beef and pork primal maps plus detailed representative cut pages.
  • Added lamb coverage, sausage science, fire/smoke/pit control, compound cooking strategies, and a seven-stage BBQ mastery path.
  • Cross-linked cuts, mechanisms, ingredients, methods, safety, protocols, and experiments in the prose.
  • Added validation rules that reject knowledge-island pages, broken links, and missing cross-domain coverage.
  • Added USDA IMPS and FSIS sources for cut terminology and sausage safety.

Why

The first version relied too heavily on sidebar navigation. Readers could encounter a cooking method or mechanism in a cut page without a direct path to the relevant explanation. This change turns the site into a navigable knowledge graph aimed at systematic BBQ theory learning.

User impact

Readers can now move directly between a concrete cut, the science behind it, relevant ingredients, single or compound cooking methods, and safety or measurement guidance. Fish remains explicitly out of scope pending a separate aquatic-food science domain.

Validation

  • ruff check .
  • pytest -q — 15 passed
  • python scripts/validate_content.py --strict
  • Metric and generated-index checks
  • mkdocs build --strict
  • Playwright click-path checks for pork → smoking → fire/smoke → compound cooking and pork map → sausage science

@StevenGGA
StevenGGA marked this pull request as ready for review August 2, 2026 05:51
@StevenGGA
StevenGGA merged commit 6c8e762 into main Aug 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant