aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-03-20 11:58:59 +0100
committerJonas Smedegaard <dr@jones.dk>2025-03-20 11:58:59 +0100
commit7efa16a6572dc8960b5d469aac551675253981d0 (patch)
tree7f872202658092709209723151fcdae4d5ed5dbd
parenta7660fdb3f5987626433170e5c9a9624f0f463a6 (diff)
add loose structural hints
-rw-r--r--_constraints.qmd18
-rw-r--r--_design.qmd4
-rw-r--r--_evaluation.qmd12
-rw-r--r--_usage.qmd12
4 files changed, 46 insertions, 0 deletions
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*