refine headlines

4 files changed, 9 insertions, 11 deletions

diff --git a/Makefile b/Makefile
index 40a708b..5f4fc3c 100644
--- a/Makefile
+++ b/Makefile
@@ -4,8 +4,6 @@ PDF_DOCUMENTS = _site/report.pdf
 
 include _make/*.mk
 
-DOCUMENT_APPENDIX_REGEX = Pandoc filter sem-md
-
 FILTER = _extensions/ruc-play/sem-md/sem-md.lua
 
 DIFFTESTS = $(patsubst %.md,%,$(wildcard test/*.md))
diff --git a/_filter.qmd b/_filter.qmd
index 3b87afb..7cf343e 100644
--- a/_filter.qmd
+++ b/_filter.qmd
@@ -10,7 +10,7 @@ which may initially seem unusual.
 *TODO: About the approach of parsing as Markdown and adjust the fallout,
 instead of writing an import extension.*
 
-## Choice of Lua
+## The choice of Lua
 
 This project is implemented in the scripting language Lua.
 
@@ -39,11 +39,11 @@ but even that aside, Lua-based filters are quite common
 and the documentation for writing them more detailed
 than the legacy JSON-based interface.
 
-## Components
+## Parsing tasks
 
 *TODO: First parse Namespace blocks, then AnnotationWords*
 
-## Tracking enclosure states
+## Keeping track of enclosure states
 
 *TODO: Details of parsing AnnotationWords
 through correlating Pandoc AST with 4 enclosure states*
diff --git a/_markdown.qmd b/_markdown.qmd
index a82f49f..fff1112 100644
--- a/_markdown.qmd
+++ b/_markdown.qmd
@@ -35,7 +35,7 @@ since it is abstractly equivalent
 to metadata embedding formats of both PDF and HTML
 (as discussed in more detail at @sec-rdf).
 
-## Syntax of Markdown dialect CommonMark
+## Syntax of dialect CommonMark
 
 Markdown consists of blocks of content,
 optionally prepended a set of Metadata blocks.
diff --git a/report.qmd b/report.qmd
index d973730..46d539b 100644
--- a/report.qmd
+++ b/report.qmd
@@ -92,11 +92,11 @@ are editorial comments not intended for inclusion in the final version.*
 
 {{< include _pandoc.qmd >}}
 
-# Extending Pandoc with a filter
+# Pandoc filter `sem-md`
 
 {{< include _filter.qmd >}}
 
-# Evaluation
+# Evaluation of `sem-md`
 
 {{< include _evaluation.qmd >}}
 
@@ -114,16 +114,16 @@ are editorial comments not intended for inclusion in the final version.*
 
 \appendix
 
-# Pandoc filter `sem-md` {.appendix}
+# Appendix: Pandoc filter `sem-md` {.appendix}
 
 ```{.lua include="sem-md/sem-md.lua" code-line-numbers="true"}
 ```
 
-# Markdown syntax as PEG {.appendix #sec-def-peg}
+# Appendix: Markdown syntax as PEG {.appendix #sec-def-peg}
 
 ```{.peg include="syntax/def.peg" code-line-numbers="true"}
 ```
 
-# Markdown syntax as syntax diagrams {.appendix #sec-def-dia}
+# Appendix: Markdown syntax diagrams {.appendix #sec-def-dia}
 
 {{< include _syntax.qmd >}}