Problem
The only zero-setup, runnable example is examples/jaffle_shop_demo/. That's a great on-ramp for dbt users, but it under-sells DataLex's broader surface — contracts, cross-repo packages, policy, glossary, multi-dialect emission.
Goal
Add a second end-to-end example that demonstrates something the jaffle demo doesn't. Candidate shapes (pick one):
examples/ecommerce_core/ — a medium-size DataLex project (50 entities) with: contracts enabled, a .datalex/snippets/audit_columns.yaml applied across entities, a policies/require_owner.yaml, a glossary of 10 terms, and two dialect outputs (Postgres + Snowflake). No dbt.
examples/cross_repo_shared_dims/ — one DataLex project that imports a second one via imports:, showing datalex packages resolve end-to-end with a lockfile.
examples/governance_starter/ — a project with sensitivity-tagged columns, policies, and a pre-built datalex emit erd Markdown output so a visitor can open it on GitHub.
Each example must include:
- A
README.md with 5-minute instructions.
- A
setup.py (or equivalent) that runs end-to-end with zero external credentials.
- A link from the main README's example index.
Acceptance criteria
python examples/<new>/setup.py succeeds on a clean clone after pip install -e '.[duckdb]'.
- The resulting DataLex project validates under
datalex validate.
- Pattern matches the existing
examples/jaffle_shop_demo/ layout and tone.
Why this is a good first issue
You'll read (not write) the core engine, which is a great way to learn the surface. The scope is self-contained and the acceptance criteria are concrete.
Problem
The only zero-setup, runnable example is
examples/jaffle_shop_demo/. That's a great on-ramp for dbt users, but it under-sells DataLex's broader surface — contracts, cross-repo packages, policy, glossary, multi-dialect emission.Goal
Add a second end-to-end example that demonstrates something the jaffle demo doesn't. Candidate shapes (pick one):
examples/ecommerce_core/— a medium-size DataLex project (50 entities) with: contracts enabled, a.datalex/snippets/audit_columns.yamlapplied across entities, apolicies/require_owner.yaml, a glossary of 10 terms, and two dialect outputs (Postgres + Snowflake). No dbt.examples/cross_repo_shared_dims/— one DataLex project that imports a second one viaimports:, showingdatalex packages resolveend-to-end with a lockfile.examples/governance_starter/— a project with sensitivity-tagged columns, policies, and a pre-builtdatalex emit erdMarkdown output so a visitor can open it on GitHub.Each example must include:
README.mdwith 5-minute instructions.setup.py(or equivalent) that runs end-to-end with zero external credentials.Acceptance criteria
python examples/<new>/setup.pysucceeds on a clean clone afterpip install -e '.[duckdb]'.datalex validate.examples/jaffle_shop_demo/layout and tone.Why this is a good first issue
You'll read (not write) the core engine, which is a great way to learn the surface. The scope is self-contained and the acceptance criteria are concrete.