Documentation on emsenn.net

Resource Cataloging

Sun, 08 Mar 2026 00:00:00 +0000

Resource cataloging is the practice of recording what resources are available, where they are, what condition they are in, and how they can be matched to need [@nelan2016; @relieftoolkit2022].

Within emergent disaster response, the term matters because supplies are not usable simply because they exist. They have to be made visible and legible to the people coordinating response. Nelan’s work on donations shows how alignment and adaptability matter in relief supply chains, while the Relief Toolkit is an explicit attempt to document and connect resources, lessons, and needs across decentralized disaster efforts [@nelan2016; @relieftoolkit2022].

Warehousing and Resource Cataloging in Emergent Disaster Response

Sun, 08 Mar 2026 00:00:00 +0000

Emergent disaster response often has to improvise logistics infrastructure quickly. Among the most important pieces are temporary warehouses and the practices of resource cataloging that make stored goods retrievable, interpretable, and movable [@wachtendorf2010; @nelan2016].

Storage as an active practice

Wachtendorf and coauthors show that large-scale disaster response is not only challenged by scarcity. It is also challenged by acquisition, reception, storage, and distribution problems created by material convergence [@wachtendorf2010]. Storage therefore is not passive. It is part of the labor of turning donations into usable support.

Markdown as Semiotic Medium

Sun, 01 Mar 2026 00:00:00 +0000

Markdown is a lightweight markup language. It is also, read as a semiotic system, a medium that makes the structure of meaning visible and machine-traversable. This lesson examines why plain text with minimal markup is an effective substrate for knowledge work — what properties it has, what it makes possible, and what it costs.

Plain text as durable substrate

A markdown file is a plain text file. This is a constraint with structural consequences:

Frontmatter Metadata

Wed, 31 Dec 2025 00:00:00 +0000

Frontmatter is a YAML header that records metadata for a markdown file.

Purpose

Identify the document (id, title or name).
Record provenance (authors, date-created).
Provide routing data (tags, dependencies, references).

Consistency

Keep metadata stable and machine-readable so tools can query a vault reliably.

Markdown Files

Wed, 31 Dec 2025 00:00:00 +0000

Markdown files are plain-text documents that mix human-readable prose with a small set of structural markers.

Structure

A file may begin with YAML frontmatter.
Headings provide a hierarchy of sections.
Links connect files and build a network of references.

Data view

Treat each file as a node with:

an identifier,
a title,
tags and dependencies,
outbound links and references.

Markdown Vaults

Wed, 31 Dec 2025 00:00:00 +0000

A vault is a collection of markdown files treated as a linked knowledge base.

Vault properties

Files are nodes; links are edges.
Frontmatter supplies stable identifiers and metadata.
Index files summarize the vault and provide entry points.

Vault hygiene

Keep id values unique and stable.
Normalize tags and dependencies.
Track missing or broken links for repair.

What is MkDocs?

Wed, 31 Dec 2025 00:00:00 +0000

MkDocs is a static site generator that builds HTML sites from markdown files.

Inputs

Markdown files with frontmatter.
A mkdocs.yml configuration file.
A theme and optional plugins.

Outputs

A static site composed of HTML, CSS, and assets.
A navigation structure derived from configuration.
Optional extra pages generated by plugins.