home.md

@@ -22,31 +22,35 @@ Each of these will be an INK recipe?
    Output: An HTML file (probably valid)
 
 ### [html-validate](html-validate-recipe)
-This should include HTML5 validation plus any ad-hoc  (html typescript) validation)
+This should include HTML5 validation plus any ad-hoc  (html typescript or project-oriented) validation.
 
 ### [html-tweak](html-tweak-recipe)
   make any adjustments to HTML @class/@style
-  via externally exposed driver
+  via externally exposed driver.  An "otherwise copy" (modified identity) transformation (i.e. results are a modified copy of the source).
 
 ### [header-promote](header-promote-recipe)
-  Convert p elements into h1-h2 based on heuristics
+  Convert p elements into h1-h6 based on heuristics. Otherwise copy.
 
 ### [ucp-adjust](ucp-adjust-recipe)
-  Adjustments warranted by/for UCP and its projects
+  Adjustments warranted by/for UCP and its projects. (Otherwise copy.)
     e.g. @class='Hypertext' -> hypertext links
 
 ### [gimme-plaintext](gimme-plaintext-recipe)
   Produces plain text version of HTML content extraction (for comparison / proofing)
+  Intended as a 'terminal' process, i.e. its results are not expected to be inputs downstream (though no one will stop you)
 
 ### [gimme-analysis](gimme-analysis)
   Produces synoptic/analytic 'map' of HTML output (element/attribute usage in hierarchy)
+  A 'terminal' process (transformation delivers results of analysis, not modified copy of source)
+
 ### [html-funnel](html-funnel-recipe)
   populate structured html section skeleton with contents from flat HTML typescript
   (i.e. converts from unstructured, to structured form, following a
-  structure externally specified)
+  structure externally specified).
+(Implemented as a 'pull', so some defensiveness i.e. validation/analysis/testing is called for to avoid dropped data.)
 
 ### [html-polish](html-polish-recipe)
-  cleanup of arbitrary html - removes redundancies and normalizes anomalies
+  cleanup of arbitrary html - removes redundancies and normalizes anomalies. (Otherwise copy.)