Skip to content

Commit 3aa2bb2

Browse files
2colorbumblefudgemishmosh
authored
Apply suggestions from code review
Co-authored-by: Bumblefudge <bumblefudge@learningproof.xyz> Co-authored-by: Mosh <1306020+mishmosh@users.noreply.github.com>
1 parent 404764d commit 3aa2bb2

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

docs/how-to/content-addressed-folders.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This matters for build outputs, software distributions, large datasets, website
2424

2525
A naive approach like hashing a tarball is fragile: tar archives encode metadata (timestamps, permissions, ordering) that vary between machines, producing different hashes for identical file contents. It's also impractical for large datasets where you cannot afford to store two copies of the data.
2626

27-
Content addressing solves this, but the choice of format has real consequences, particularly for overhead, determinism, language support and interoprability within an ecosystem.
27+
Content addressing solves this, but the choice of format has real consequences, particularly for overhead, determinism, language support and interoperability within an ecosystem.
2828

2929
These differences compound as dataset size grows: what's negligible at megabyte scale —a few extra bytes of framing, an extra round of parsing per block— becomes a meaningful cost at terabyte scale across millions of files.
3030

@@ -103,7 +103,7 @@ Large individual files also benefit: because UnixFS splits files into a DAG of c
103103

104104
## DASL, MASL, and DRISL
105105

106-
[DASL](https://dasl.ing) (Data Addressed Structures and Links) is a family of specs emerging from the Bluesky/AT Protocol ecosystem that provide content-addressed data structures built on CBOR rather than protobuf.
106+
[DASL](https://dasl.ing) (Data Addressed Structures and Links) is a set of simple, standard primitives for working with content-addressed, linked data. Designed as a web-friendly, interoperable subset of IPFS and IPLD primitives, DASL is used in production by the AT Protocol ecosystem, including Bluesky.
107107

108108
**[DRISL](https://dasl.ing/drisl.html)** (Deterministic Representation for Interoperable Structures & Links) is a constrained CBOR application profile designed for deterministic serialization:
109109

@@ -117,7 +117,7 @@ Large individual files also benefit: because UnixFS splits files into a DAG of c
117117
- **Single mode** (`src`): wraps one resource with metadata (content type, etc.)
118118
- **Bundle mode** (`resources`): maps file paths to resource CIDs with per-file metadata — essentially a directory representation
119119

120-
MASL bundles are conceptually similar to iroh collections: a flat map of paths to content hashes, no directory hierarchy nodes. The key difference is MASL also carries per-resource metadata (like content types) and uses CIDs (self-describing, multi-codec identifiers) rather than raw BLAKE3 hashes. Like iroh collections, subsetting operates at the individual file level — there is no native subdirectory addressing.
120+
MASL bundles are conceptually similar to iroh collections: a flat map of paths to content hashes, no directory hierarchy nodes. The key difference is MASL also carries per-resource metadata (like content types) and uses CIDs (self-describing, multi-codec identifiers) rather than raw BLAKE3 hashes. Like iroh collections, subsetting operates at the individual resource level — there is no native subdirectory addressing.
121121

122122
Because DRISL and MASL build on CBOR — a widely supported serialization format with libraries in virtually every language — they likely have the widest potential for cross-language implementation. A [cross-implementation test suite](https://hyphacoop.github.io/dasl-testing/) tracks conformance across languages.
123123

0 commit comments

Comments
 (0)