Architecture concept

Verification Required

Durability and evidence levels.

Use these levels to explain what current evidence proves before a docs claim moves from local observation to storage, acknowledgement, replication, preview, or reviewer-held language. The goal is simple: source contracts are useful, but they are not shipped capability claims until evidence and reviewers support the exact wording.

Level Snapshot

Evidence levels
6
Product examples
4
Default posture
Verify
Review state
Pending

Evidence Ladder

Local

Alpha

The behavior was observed in a loopback service, local binary, local adapter, smoke path, fixture, or developer workflow.

Use when: Use for first-success docs, local quickstarts, alpha tutorials, local CLI examples, local route references, and diagnostic workflows.

Required evidence: Name the command, route, binary, configuration, fixture, environment, and expected output that reviewers can re-run or inspect.

Does not prove: Does not prove deployment posture, shared storage, restart behavior outside the named path, failure handling, multi-node behavior, or customer support coverage.

Durable

Verification Required

A write or record is retained by a named storage path, persistence mode, WAL, segment bundle, queue state, or adapter behavior under stated assumptions.

Use when: Use only when the docs name the product surface, storage mode, data path, acknowledgement point, restart or recovery condition, and evidence owner.

Required evidence: Attach source, route, config, test, fixture, or runbook evidence for the persistence path and the specific failure or restart condition covered.

Does not prove: Does not prove availability outcomes, broad recovery behavior, topology-independent retention, or stronger product support without operations review.

Committed

Verification Required

The docs can point to a named commit point before acknowledgement, such as a local WAL append, segment publication step, queue-state mutation, or product-specific acceptance rule.

Use when: Use when a page needs to explain acknowledgement order, commit sequence, record visibility, cursor movement, queue mutation, or publication sequencing.

Required evidence: Name the route or handler, the commit point, the acknowledgement condition, visibility expectations, replay or recovery assumptions, and negative cases.

Does not prove: Does not prove quorum behavior, cross-site outcomes, visible reads in another component, or a general durability claim unless those facts are separately reviewed.

Replicated

Verification Required

Evidence shows data, messages, frames, or records copied, applied, or validated across a named source and target under a stated topology or proof slice.

Use when: Use for selected replication-status routes, target-apply routes, local replicated modes, protocol-frame evidence, or topology-specific validation notes.

Required evidence: Attach source and target identity, topology, transport, failure boundary, apply or acknowledgement rule, test output, and operations reviewer acceptance.

Does not prove: Does not prove failover, disaster recovery, support coverage, customer-owned storage publication, or every topology the product may later support.

Preview

Preview Contract

A contract, fixture, SDK surface, schema, planned route, validation command, or product direction exists, but the complete customer-facing runtime is not live.

Use when: Use for roadmap-adjacent concepts, route shapes, schema models, SDK entry points, compatibility fixtures, and product direction that reviewers may discuss safely.

Required evidence: Name the contract, fixture, schema, prototype, design note, accepted gap, or backlog item and keep the owning maturity label visible.

Does not prove: Does not prove runtime support, customer availability, operational readiness, or compatibility with external clients until runtime evidence exists.

Verification Required

Verification Required

The claim touches sensitive product behavior or reviewer-owned risk and must not be strengthened until evidence and signoff are attached.

Use when: Use for durability, availability, security, compliance, support, scale, performance, identity, failover, cross-product, or customer-commitment language.

Required evidence: Attach evidence records, known limits, owner review, required claim labels, and product, operations, security, legal, support, privacy, or docs QA acceptance as applicable.

Does not prove: Does not approve the claim by itself. It is a hold state that tells readers and reviewers what must happen before promotion.

Product Examples

Evidence level examples by product
ProductWording areaMinimum levelNeeded evidenceBoundary
ObjectDBS3 Core bucket and object operations over the current local adapter.Local or Durable, depending on the claimDOCS-029, DOCS-030, DOCS-038, local adapter limits, operation-specific route evidence, and any storage-mode proof for stronger wording.Do not turn local adapter success into broad S3 parity, topology-independent retention, or support coverage.
Message BrokerStream publish, replay, cursor movement, and shared queue mutation.Committed for acknowledgement order; Replicated only for named proof slicesDOCS-031, DOCS-032, DOCS-040, runtime route evidence, queue-state evidence, audit evidence, and selected packet records for replication wording.Do not turn route-family evidence into Kafka listener support, strict cross-site outcomes, or pilot readiness without selected signoff.
ConcordiaCache persistence, Gateway accepted diagnostics, Storage validation flags, and TSDB local retention.Local or PreviewDOCS-035, DOCS-041, DOCS-042, Cache smoke output, Gateway fixture evidence, Storage startup validation, and TSDB local shell evidence.Do not turn accepted diagnostic output into quorum commit, visible reads, shared storage, owner forwarding, or cross-node routing proof.
LogDBOTLP ingest, WAL-backed publication, segment bundles, retained query, and S3 query-read settings.Committed for acknowledgement order; Durable for named local retention evidenceDOCS-033, DOCS-034, DOCS-039, WAL source, segment-bundle source, query handler evidence, and S3 query-read configuration evidence.Do not turn S3 query-read into S3 publication, BYOC readiness, public replay APIs, external sinks, or distributed query support.

Claim Promotion Flow

  1. Start With The ClaimIdentify the exact sentence, product, route, version, deployment mode, and reader decision the wording could influence.
  2. Choose The Weakest LevelPick the lowest level that honestly matches the evidence, then keep the maturity label and known limit near the claim.
  3. Attach ProofLink source, tests, fixtures, release notes, commands, expected output, owner, date, status, and what the evidence excludes.
  4. Route ReviewUse product, operations, security, privacy, legal, support, docs QA, or docs lead reviewers when the claim changes risk.

Do Not Infer

Contracts Are Not Runtime Support

A route shape, SDK method, schema, protocol frame, or fixture can support preview language without proving the complete user-facing behavior.

Storage Evidence Is Scoped

A named WAL, adapter, queue-state file, segment bundle, or persistence path only supports the environment, mode, and failure condition it was reviewed for.

Replication Needs Topology

Replication wording needs source, target, topology, transport, apply rule, failure boundary, and operations review before it can move beyond a proof slice.

Evidence

DOCS-046 evidence map
Level areaEvidenceStatus
Evidence-level definitions and claim promotion rulesDOCS-006, DOCS-007, DOCS-008, DOCS-010, DOCS-043pending
ObjectDB storage and S3 Core evidence boundariesDOCS-029, DOCS-030, DOCS-038, ODB-EVID-004, ODB-EVID-010pending
Message Broker commit, replay, queue, and replication boundariesDOCS-031, DOCS-032, DOCS-040, SMB-EVID-010, SMB-EVID-011pending
Concordia local, preview, Storage, and Gateway boundariesDOCS-035, DOCS-041, DOCS-042, CONC-EVID-012, CONC-EVID-013pending
LogDB WAL, segment, query, and S3 query-read boundariesDOCS-033, DOCS-034, DOCS-039, LDB-EVID-010, LDB-EVID-011pending

Internal review records track this concept page and its evidence-level boundaries.

Safe Next Steps

  • Available: DOCS-007

    Use the claim-review checklist

    Apply required reviewers and evidence expectations before publishing sensitive durability, availability, support, or scale language.

  • Available: DOCS-043

    Review compatibility verification

    Use matrix owners, stale warnings, and release-note triggers before promoting row status or claim wording.

  • Available: E06

    Compare compatibility rows

    Check supported, partial, unsupported, preview, future, and verification-required rows before choosing an evidence level.

  • Available: DOCS-045

    Read product mental models

    Use product nouns correctly before deciding whether a claim is local, durable, committed, replicated, preview, or review-held.