From 7efa16a6572dc8960b5d469aac551675253981d0 Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Thu, 20 Mar 2025 11:58:59 +0100
Subject: add loose structural hints

---
 _constraints.qmd | 18 ++++++++++++++++++
 _design.qmd      |  4 ++++
 _evaluation.qmd  | 12 ++++++++++++
 _usage.qmd       | 12 ++++++++++++
 4 files changed, 46 insertions(+)

diff --git a/_constraints.qmd b/_constraints.qmd
index 7ea2a93..568e529 100644
--- a/_constraints.qmd
+++ b/_constraints.qmd
@@ -1 +1,19 @@
 *TODO*
+
+In the source format of Markdown with with annotations...
+
+* the syntax for annotation **should* be relatively human comprehensible
+  (in the same spirit as Markdown -- e.g. \*\*strong emphasis\*\*)
+* annotation syntax **must not** conflict with core Markdown
+  (i.e. must not cause disambiguations)
+* annotation syntaxt **should not** conflict with other Markdown extensions
+
+For syntactically correct and structurally supported annotations...
+
+* visual output **must** be identical to source without the annotation
+* metadata of output **must** contain the annotation
+
+For syntactically incorrect or structurally unsupported annotations...
+
+* the annotation **must not** disappear from visual output
+* visual output **should** include the annotation in source form
diff --git a/_design.qmd b/_design.qmd
index 7ea2a93..ee03381 100644
--- a/_design.qmd
+++ b/_design.qmd
@@ -1 +1,5 @@
 *TODO*
+
+## XMP, RDFa and RDF
+
+*TODO*
diff --git a/_evaluation.qmd b/_evaluation.qmd
index 7ea2a93..36b9538 100644
--- a/_evaluation.qmd
+++ b/_evaluation.qmd
@@ -1 +1,13 @@
 *TODO*
+
+## Unit testing
+
+*TODO*
+
+## Validation of output formatting
+
+*TODO*
+
+## Evaluation of practical use
+
+*TODO*
diff --git a/_usage.qmd b/_usage.qmd
index 7ea2a93..b363b7b 100644
--- a/_usage.qmd
+++ b/_usage.qmd
@@ -1 +1,13 @@
 *TODO*
+
+## Setup
+
+*TODO*
+
+## Use
+
+*TODO*
+
+## Tricks
+
+*TODO*
-- 
cgit v1.2.3