Skip to content

Commit f1b781e

Browse files
authored
Merge pull request #67 from darobin/fix/de-nonsensify-description-of-DAG-JSON
address issue 65
2 parents e59087e + 7951e57 commit f1b781e

File tree

1 file changed

+0
-19
lines changed

1 file changed

+0
-19
lines changed

drisl.src.html

Lines changed: 0 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -70,24 +70,5 @@ <h2>CIDs in CBOR</h2>
7070
For more information, see the [[cbor-tag42]] appendix to the [[drisl]] specification.
7171
</p>
7272
</section>
73-
<section>
74-
<h2>Debugging Considerations</h2>
75-
<p>
76-
It is often convenient to represent DRISL in textual formats for debugging
77-
purposes, for example using JSON.
78-
</p>
79-
<p>
80-
One common convention for doing so is historically referred to as "DAG-JSON," which is a JSON expression
81-
of the DRISL data in which CIDs are represented as the object
82-
<code>{ "/": "string CID" }</code>, i.e., DASL CIDs in their base-32 ASCII representation ([[cid]]), NOT in their CBOR representation ([[cbor-tag42]])). Another option is
83-
<a href="https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/">CBOR
84-
Extended Diagnostic Notation</a>.
85-
</p>
86-
<p>
87-
In any case, note that the CIDs used in such debugging outputs that may
88-
point to <em>other</em> parts of the debugging output should be the CIDs
89-
of the DRISL content, not of the debugging resources.
90-
</p>
91-
</section>
9273
</body>
9374
</html>

0 commit comments

Comments
 (0)