@@ -189,11 +189,14 @@
                            [listing-full-html    string/f]
                            [listing-excerpt-html string/f]
                            [listing-short-html   string/f])
             #:constructor-name make-cache:article]{
 
-Table holding cached article information.
+Table holding cached @tech{article} information.
+
+When creating a @racket[cache:article] (should you ever need to do so directly, which is unlikely),
+the only required fields are @racket[_page], @racket[_title], and @racket[_conceal].
 
 }
 
 @defstruct*[cache:note ([id              id/f]
                         [page            symbol/f]
@@ -210,11 +213,11 @@
                         [listing-full-html    string/f]
                         [listing-excerpt-html string/f]
                         [listing-short-html   string/f])
                        #:constructor-name make-cache:note]{
 
-Table holding cached information on notes.
+Table holding cached information on @tech{notes}.
 
 }
 
 @defstruct*[cache:index-entry ([id id/f]
                                [entry       string/f]
@@ -221,11 +224,11 @@
                                [subentry    string/f]
                                [page        symbol/f]
                                [html-anchor string/f])
                               #:constructor-name make-cache:index-entry]{
                               
-Table holding cached information about index entries found in articles.
+Table holding cached information about index entries found in @tech{articles}.
 
 }
 
 @defstruct*[listing ([path        string/f]
                      [title       string/f]