warpfork

Git archive. Comparable to tar, in a way.

Purpose

Maintains directories of Content Addressable content.

Meant to play nice as a provider of an immutable append-only cache that's easy to integrate with any system based on files and directories.

warpfork

I'm not sure if this is a good list of issues I have with Rust.

Maybe some of them can be addressed. Maybe even immediately, in ways I don't yet know.

But the theme of the file below is that I started very enamored with rust... and then my practical experience with it after about a hundred hours was that I had staggeringly low productivity, because of an endless series of papercuts.

I'm no longer convinced rust is a slam dunk choice. (But I still wish it was.)

warpfork

This is a working document to snapshot some thoughts about the evolution of Warpforge and its APIs.

Observations (that lead to some desires for changes)

• We should seriously consider moving the Catalogs to an even yet plainer format.
  • The Catalog format as it stands today is a pain to edit manually, due to its inclusion of hashes. (This has been remarked upon by essentially every user to date.)
  • We also derive very little value from the use of hashes in the middle of the Catalog data, because in practice, we find we're continuously embedding the Catalog data in other version control systems, which already contain their own checksums. While there is elegance to having our own hashing scheme provide our own bespoke incrementally verifiable trees, there is little strong demonstration of that providing direct value (and very many demonstrations of it creating problematic friction).
  • The Catalog format seems like it could become more generally usable (and thus more appealing for others to interact

warpfork

Text Catalogs: an RFC

Abstract

This document proposes "Text Catalogs" -- "tcat" for short -- a convention for file naming and content organization for document stores. Text Catalogs are specifically aimed to be legible to humans, friendly to version control,

warpfork

#!/bin/bash
set -euo pipefail
#set -x


## HOW TO HOLD IT:
##
##   Give the program you want to zapp as the first argument.
##
##   For the couple of different usage patterns:

warpfork

WarpVer Versioning

A software versioning scheme.

It's not semver ™️.

The Rules

warpfork

Static Site Generator Roundup 2021

Criteria & Considerations

• does it consume markdown?
• is it fast?
  • (a "hello world" site should take milliseconds or less to build. Definitely not full seconds; certainly not multiple full seconds.)
• is it reasonably shipped?

warpfork

IPLD Strings

For an IPLD library to have "Complete" support for the IPLD Data Model, Strings MUST support the full range of 8-bit bytes. Strings SHOULD use UTF-8, and library designers may encourage this however they see fit. In particular, NFC-normalized form is encouraged. However, this MUST NOT result in the inability of a library to handle non-UTF-8 byte sequences where Strings are handled, nor should libraries apply normalizations to data they read. (In other words: using normalized forms when creating new data is encouraged,

warpfork

Strings in IPLD

"Strings" are a familiar concept in how programs handling digital data. However, for all its familiarity, it is also subtle. Solid systems require clear specifications. In this document, we will describe Strings in IPLD, where they appear, and what specifications we make about their domain.

Prerequisites

warpfork

Data Model: Order of Maps

Maps in IPLD are typically order-preserving: if you put data into them in some order, you can expect that the iterators will return that information in the same order; and transformation functions will generally operate on data without reordering it.

However, there are also several exceptions to this rule, so it's important to be aware of what to expect in the different scenarios.