@@ -56,10 +56,14 @@
 see, e.g., @filepath{tags-html.rkt}.
 
 Functions defined with this macro @emph{do not} accept keyword arguments. If you need keyword
 arguments, see @racket[poly-branch-kwargs-tag].
 
+@margin-note{The thought behind having two macros so similar is that, by cutting out handling for keyword
+arguments, @racket[poly-branch-tag] could produce simpler and faster code. I have not verified if
+this intuition is meaningful or correct.}
+
 @defproc[#:kind "syntax"
          (poly-branch-kwargs-tag (id symbol?))
          (-> txexpr?)]
 
 Works just like @racket[poly-branch-tag], but uses Pollen’s @racket[define-tag-function] so that
@@ -66,18 +70,26 @@
 keyword arguments will automatically be parsed as X-expression attributes.
 
 Additionally, the branch functions called from the new function must accept exactly two arguments:
 a list of attributes and a list of elements.
 
-@margin-note{The thought behind having two macros so similar is that, by cutting out handling for keyword
-arguments, @racket[poly-branch-tag] could produce simpler and faster code. I have not verified if
-this intuition is meaningful or correct.}
-
 @section{Markup reference}
 
 These are the tags that can be used in any of @italic{The Local Yarn}’s Pollen documents (articles,
 etc).
+
+@defproc[(title [element xexpr?] ...) txexpr?]
+
+@margin-note{The @code{title} function is not actually defined in @filepath{pollen.rkt} or anywhere
+else. In Pollen, any undefined function @tt{title} defaults to @racket[(default-tag-function
+title)], which is what I want. It is documented here because its presence or absence has
+side-effects on the display of the article.}
+
+Supplies a title for the document. You can use any otherwise-valid markup within the title tag. 
+
+Titles are optional; if you don’t specify a title, the article will appear without one. This is
+a feature!
 
 @defproc[(p [element xexpr?] ...) txexpr?]
 
 Wrap text in a paragraph. You almost never need to use this tag explicitly; 
 just separate paragraphs by an empty line.