feat: rewrite docs
This commit is contained in:
140 files changed
+4555
-701
No files matched your search
+2
-2
@@ -10,14 +10,14 @@ In this chapter *H* is SHA-256 written as hexadecimal; under a keyed scheme, *H*
|
||||
|
||||
| Value | Definition | Used for |
|
||||
| --- | --- | --- |
|
||||
| `text_hash` | *H*(normalize(plain projection)) | Quotations and Lode's verbatim check, where every character counts. |
|
||||
| `text_hash` | *H*(normalize(plain projection)) | Quotations and verbatim checks, where every character counts. |
|
||||
| `match_hash` | *H*(strict projection) | Certifying that two witnesses agree, and recognizing the same text elsewhere. |
|
||||
| `align_key` | *H*(lossy projection) | Proposing alignments. It never certifies anything. |
|
||||
| `own_hash` | *H*(canonical JSON of the node's own content, [5.2](#52-own-content)) | Anchors on containers that have content of their own. |
|
||||
| `node_hash` | *H*(canonical JSON of `{"own": own_hash, "children": [each child's node_hash, in order]}`) | Pins on leaves; the root hash; knowing that something below has changed. |
|
||||
|
||||
Normalization is that of [1.4](01-conventions.md#14-text-normalization-for-hashing).
|
||||
Because each `node_hash` covers its children's, the root's `node_hash` is a Merkle root: a correction to one sentence changes that sentence's values and the `node_hash` of each ancestor, and nothing else.
|
||||
Because each `node_hash` covers its children's, the root's `node_hash` covers the whole tree (it is a hash over canonical JSON of `{own, children}`, not an RFC 6962 Merkle root, which [8.5](08-fidelity.md#85-merkle-roots) defines for receipts): a correction to one sentence changes that sentence's values and the `node_hash` of each ancestor, and nothing else.
|
||||
`hashes.jsonl` gives every value for every node of a small document, with each node's own content.
|
||||
|
||||
## 5.2 Own content
|
||||
|
||||
Reference in new issue
Block a user