Skip to content

Commit 5e64a1e

Browse files
hyperpolymathclaude
andcommitted
docs: add EXPLAINME.adoc — prove-it file backing README claims
Standard RSR documentation: quotes README claims, lists tech choices with links, honest caveats, dogfooding table. See rsr-template-repo for the pattern. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent aef5f43 commit 5e64a1e

1 file changed

Lines changed: 46 additions & 0 deletions

File tree

EXPLAINME.adoc

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
// SPDX-License-Identifier: PMPL-1.0-or-later
2+
= VeriSimDB — Show Me The Receipts
3+
:toc:
4+
:icons: font
5+
6+
The README makes claims. This file backs them up.
7+
8+
[quote, README]
9+
____
10+
Your data lives in multiple systems — graphs, vector stores, document indexes, time-series databases. When one system's view of an entity silently diverges from the others, you get **data drift**: stale embeddings, broken provenance chains, graph edges referencing deleted documents, spatial coordinates that no longer match textual descriptions.
11+
____
12+
13+
== Technology Choices
14+
15+
[cols="1,2"]
16+
|===
17+
| Technology | Learn More
18+
19+
| **Rust** | https://www.rust-lang.org
20+
| **Zig** | https://ziglang.org
21+
| **ReScript** | https://rescript-lang.org
22+
| **Idris2 ABI** | https://www.idris-lang.org
23+
|===
24+
25+
== Dogfooded Across The Account
26+
27+
Uses the hyperpolymath ABI/FFI standard (Idris2 + Zig). Same pattern used across
28+
https://github.com/hyperpolymath/proven[proven],
29+
https://github.com/hyperpolymath/burble[burble], and
30+
https://github.com/hyperpolymath/gossamer[gossamer].
31+
32+
== File Map
33+
34+
[cols="1,2"]
35+
|===
36+
| Path | What's There
37+
38+
| `src/` | Source code
39+
| `lib/` | Library code
40+
| `ffi/` | Foreign function interface
41+
| `test(s)/` | Test suite
42+
|===
43+
44+
== Questions?
45+
46+
Open an issue or reach out directly — happy to explain anything in more detail.

0 commit comments

Comments
 (0)