Skip to content

Commit 5f4c6b8

Browse files
hyperpolymathclaude
andcommitted
docs(explainme): improve completeness per README-EXPLAINME-STANDARD
Add :toc: preamble and :icons: font attributes. Add dogfooding table (3 rows) covering Idris2 ABI/Zig FFI standard, Rust compiler pipeline, and formal semantics/topological domain — with cross-account context. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 73699bf commit 5f4c6b8

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

EXPLAINME.adoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
33

44
= EXPLAINME: Tangle
5+
:toc: preamble
6+
:icons: font
57

68
== A Turing-Complete Topological Programming Language
79

@@ -48,3 +50,22 @@ not via a traditional proof.
4850
| `examples/`
4951
| Worked examples demonstrating language features
5052
|===
53+
54+
== Dogfooded Across The Account
55+
56+
[cols="1,2,2", options="header"]
57+
|===
58+
| Technology / Pattern | Role in Tangle | Also Used In
59+
60+
| *Idris2 ABI + Zig FFI standard*
61+
| `src/abi/` -- Idris2 dependent types for braid-word ASTs, isotopy witness types, and ABI contracts; `ffi/` Zig FFI layer for C-compatible runtime interop
62+
| gossamer, burble, ephapax, hypatia, verisimdb, typed-wasm -- universal pattern across the estate
63+
64+
| *Rust compiler pipeline*
65+
| `src/rust/` -- lexer, parser (EBNF grammar at `src/tangle.ebnf`), type checker (`Word[n]` vs `Tangle[A,B]`), evaluator, WASM codegen target
66+
| ephapax (17-crate Rust workspace), panic-attack (Rust analysis engine), k9-rs, a2ml-rs
67+
68+
| *Formal semantics + topological domain*
69+
| `docs/spec/FORMAL-SEMANTICS.md` -- denotational model for tangle programs; isotopy-class equivalence; Reidemeister-move reduction rules
70+
| KnotTheory.jl (Julia knot invariant library), KRLAdapter.jl (KRL bridging), typed-wasm (structured braid-type analogues), standards (spec-first documentation pattern)
71+
|===

0 commit comments

Comments
 (0)