@@ -2,10 +2,11 @@
 
 @; 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
           (for-label "../pollen.rkt"))
 
 @(require (for-label racket/base))
 
 @title{Basic Notions}
@@ -29,21 +30,23 @@
  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 every published edit to an article to be
  findable and linkable. I want addenda 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{Experimentation must be accomodated gracefully.} I should be able to write fiction,
- poetry, opinion pieces, minor observations or collections, or anything else, and have or create
- a good home for it here. Where dissimilar writings appear together, there should be signals that
- help the reader understand what they are looking at, switch contexts, and find more if they wish.}
+ @item{@bold{The system will gracefully accomodate experimentation.} I should be able to write
+ fiction, poetry, opinion pieces, minor observations or collections, or anything else, and have or
+ create a good home for it here.}
  
  @item{@bold{Everything produced here should look good.}}
 
- @item{@bold{Reward exploration without disorienting the reader.}}
+ @item{@bold{Reward exploration without disorienting the reader.} Draw connections between related
+ thoughts using typographic conventions and organizational devices that would be familiar to
+ a reader of books. Where dissimilar writings appear together, place signals that help the reader
+ understand what they are looking at, switch contexts, and find more if they wish.}
  
- @item{@bold{Everything produced here should be the result of an automatable process.} No clicking
- around to publish web pages and books.}
+ @item{@bold{Everything is produced, and reproducible, by an automatable process.} No clicking or
+ tapping around in GUI apps to publish web pages and books.}
  
  ]
 
 @section{Names for things and how they fit together}
 
@@ -66,13 +69,16 @@
 @subsection{Notes}
 
 A @deftech{note} is a comment or addendum to an @tech{article} using the @racket[note] tag. It may
 be written by the same person who wrote the article, or submitted by a reader.
 
-A note appears at the bottom of the article to which it is attached, but it also appears in the blog
-and in the RSS feed as a separate piece of content, and is given the same visual weight as actual
-articles.
+@(define-runtime-path diagram-notes "diagram-notes.png")
+@centered{@responsive-retina-image[diagram-notes]}
+
+As shown above, a note appears at the bottom of the article to which it is attached, but it also
+appears in the blog and in the RSS feed as a separate piece of content, and is given the same visual
+weight as actual articles.
 
 A note may optionally have a @deftech{disposition} which reflects a change in attitude towards its
 parent article. A disposition consists of a @italic{disposition mark} such as an asterisk or dagger,
 and a past-tense verb. For example, an author may revisit an opinion piece written years earlier and
 add a note describing how their opinion has changed; the tag for this note might include