ADDED   code-docs/design.scrbl
Index: code-docs/design.scrbl
==================================================================
--- code-docs/design.scrbl
+++ code-docs/design.scrbl
@@ -0,0 +1,38 @@
+#lang scribble/manual
+
+@; SPDX-License-Identifier: BlueOak-1.0.0
+@; This file is licensed under the Blue Oak Model License 1.0.0.
+
+@(require "scribble-helpers.rkt"
+          racket/runtime-path)
+
+@(require (for-label racket/base))
+
+@title{Design and Layout}
+
+The design and implementation of @italic{The Local Yarn} are guided by a few basic requirements that
+have evolved since I started the site in 1999.
+
+@itemlist[
+  @item{@bold{The writing will live in two places: on a web server, and on bookshelves.} The web
+  server, because it’s a fun, fast way to publish writing and code to the whole world (you knew that
+  already); but also on bookshelves, because
+  @ext-link["https://thelocalyarn.com/excursus/secretary/posts/web-books.html"]{a web server is like
+  a projector}, and I want to be able to turn it off someday and still have something to show for
+  all my work. Plus, I just like printed books.}
+
+  @item{@bold{Addenda to older writings should be highly visible.} I like to revisit, resurface and
+  amend things I’ve written before. Views change, new ideas come along. In a typical blog the focus
+  is always at whatever’s happening at the head of the time stream; an addendum to an older post is,
+  for all practical purposes, invisible and nearly useless. I want them to be extremely visible.
+  These addenda should also be able to mark major shifts in the author’s own perspective on what
+  they originally wrote.}
+
+  @item{@bold{Finally: everything produced here, both in print and on the web, should look good.}}
+]
+
+@nested[#:style 'inset]{
+  “Yet modest ornament with use combined @(linebreak)
+  Attracts the eye to exercise the mind.” @(linebreak)
+  —@ext-link["https://en.wikipedia.org/wiki/Samuel_Rogers"]{Samuel Rogers}
+}

ADDED   code-docs/tour.scrbl
Index: code-docs/tour.scrbl
==================================================================
--- code-docs/tour.scrbl
+++ code-docs/tour.scrbl
@@ -0,0 +1,13 @@
+#lang scribble/manual
+
+@; SPDX-License-Identifier: BlueOak-1.0.0
+@; This file is licensed under the Blue Oak Model License 1.0.0.
+
+@(require "scribble-helpers.rkt")
+
+@(require (for-label racket/base))
+
+@title{A Tour: Publishing on @italic{The Local Yarn}}
+
+It’s pretty simple.
+