SEP 18: Document Summaries

This is considered a blocking issue for SEP 17: Document Transclusion.

I have long wanted summaries of documents.

I envision three ways of defining a document summary (and intend to implement all three as they seem to me to serve distinct, useful purposes):

  1. In the document frontmatter

  2. By tagging a particular paragraph within the document as the summary

  3. Automatically

This list also represents the hierarchy of these methods, ie where a summary exists in the frontmatter this takes precedence, followed by a definition in the body, with an auto-summary being considered least desirable.