diff --git a/README.md b/README.md index a418800..b304a08 100644 --- a/README.md +++ b/README.md @@ -12,8 +12,21 @@ the measurements to 600 GB - 6 TB, and produces a ranked decision report for five laboratory use cases: analysis, reporting, search/filtering, archiving, and inter-lab exchange. +**Results - interactive, single-file HTML (open in a browser or download and share):** + +- **[Storage Format Evaluation](https://git.boskadoff.com/Public/LabDataStorageEvaluation/raw/branch/master/docs/research/Tribology_Storage_Evaluation.html)** - + the full study results: dashboard, measured matrix, projections to 6 TB, + hardware bill of materials, weighted scoring and verdict + (source: [docs/research/Tribology_Storage_Evaluation.html](docs/research/Tribology_Storage_Evaluation.html)). +- **[Foreign-Key Architecture Study](https://git.boskadoff.com/Public/LabDataStorageEvaluation/raw/branch/master/docs/research/Tribology_FK_Architecture.html)** - + the measured key-schema study behind the relational design decision + (source: [docs/research/Tribology_FK_Architecture.html](docs/research/Tribology_FK_Architecture.html)). + +Reference documents: + - Task specifications: [docs/specs/](docs/specs/) (plan + tasks 01-11). - Binding conventions: [docs/rules/](docs/rules/) and [CLAUDE.md](CLAUDE.md). +- Full decision report (markdown): [out/report/REPORT.md](out/report/REPORT.md). ## Goals @@ -144,8 +157,7 @@ docs/ Initial_Prompt.md the generative prompt behind specs 00-11 (provenance, non-binding) specs/ task specifications 00-11 (WHAT to build) rules/ binding conventions (HOW work is done) - research/ measured design studies (e.g. FK key-schema study) - examples/ imported reference materials (not binding) + research/ measured design studies and interactive result pages out/ ALL generated artifacts (reproducible; bulk git-ignored, report/ config/ .done/ committed - see .gitignore): config/ csv/ json/ sqlite/ pg/ rdf/ bench/ report/ .done/ diff --git a/docs/research/Tribology_FK_Architecture.html b/docs/research/Tribology_FK_Architecture.html index 1646f48..bae7f5b 100644 --- a/docs/research/Tribology_FK_Architecture.html +++ b/docs/research/Tribology_FK_Architecture.html @@ -533,7 +533,7 @@ CREATE TABLE friction_cycles (
Measured 2026-07-11 on the deterministic simulated corpus (seed 20260711, 141.8 MiB CSV) · SQLite, warm OS cache, best of 3 runs · scripts: measure_key_variants.py (build + size + load + Q1) and read_benchmarks.py (six read patterns) · - companion page: Tribology_Ontology.html (measurement-result registry). + companion page: Storage Format Evaluation (full study results).
diff --git a/docs/rules/code-data-formatting.md b/docs/rules/code-data-formatting.md index 73813b1..14f2889 100644 --- a/docs/rules/code-data-formatting.md +++ b/docs/rules/code-data-formatting.md @@ -78,8 +78,6 @@ an en-dash. content, not typographic substitutions. UTF-8 throughout is the right answer. (Repository artifacts are English; this matters only for quoted material.) -- **Imported reference materials** in `docs/examples/` are kept verbatim as - received; they are not binding documents. ## 4. Detection / enforcement @@ -89,8 +87,7 @@ future detector is documented here so it can be built consistently: - **What it flags.** Any occurrence of the Unicode codepoints in the section 1 substitution table inside in-scope files. The section 3 exemptions - (scientific notation, international content, `docs/examples/`) are the only - carve-outs. + (scientific notation, international content) are the only carve-outs. - **Exit behavior.** Non-zero exit when any flagged codepoint is found under the scan roots, so it can later gate a commit hook or a build step. - **Tooling.** When this detector is created it MUST be a PowerShell script