This document defines what belongs in the Zoo, what belongs in References only, and the minimum quality bar for public-facing entries.
1) Inclusion criteria (Zoo)
A note belongs in Zoo/ only if it is a hardware modality, architecture primitive, or fault-tolerant logical qubit construct that has enduring value beyond a single paper.
Include if the item is one of:
- Physical qubit modality (e.g., transmon, trapped-ion, spin qubit, neutral-atom, photonic)
- Architecture primitive with stable identity (e.g., tunable coupler, circuit-QED as coupling stack)
- Logical/topological code family used as a qubit abstraction (e.g., surface-code logical qubit)
Exclude from Zoo (References-only):
- Generic algorithm papers
- Software-stack/tooling reviews
- Application-domain surveys (finance, CFD, digital health, etc.)
- Single-paper findings that do not define a durable modality/primitive
2) Reference handling
- Every Zoo entry should link at least one seminal reference.
- New papers about an existing Zoo entry should generally update
References/and cross-links, not overwrite the Zoo page.
3) Minimum quality bar for status: demonstrated
A demonstrated Zoo page must contain:
- Clear modality-level description (not title/abstract boilerplate)
- At least one governing Hamiltonian or stabilizer formalism
- Metrics table including a Fidelity reference column
- At least one seminal linked paper
- Related-entry links to neighboring modalities/primitives
Optional but encouraged:
- Figure/schematic
- Explicit scaling bottlenecks
- Typical operating regime values
4) Metadata policy
first_proposed_year= year of first proposal of the modality, not year of latest processed paper.technology_familyshould never beUnknownfor stable Zoo entries.generated_byvalues:scibok-curationfor human-curated/public-facing entriesseed-ingest-v1only for legacy seed notes pending promotion
5) Protection policy
Pipeline safety rule:
- Curated/demonstrated Zoo entries are protected from automated overwrite.
- Automated processing may append References and side artifacts, but cannot downgrade entry quality.
6) Promotion workflow (seed → demonstrated)
To promote a seed entry:
- Verify historical metadata (year, seminal refs)
- Add physics section + Hamiltonian
- Add metrics table with fidelity source references
- Validate links and taxonomy conventions
- Set
status: demonstrated,generated_by: scibok-curation