add glossary

1 files changed, 21 insertions, 0 deletions

diff --git a/SPEC.md b/SPEC.md
new file mode 100644
index 0000000..f921c1c
--- /dev/null
+++ b/SPEC.md
@@ -0,0 +1,21 @@
+# A plain-text in-code format for issue management
+
+## Glossary
+
+comment
+: A comment block with a comment marker and Markdown content.
+
+comment block
+: A multi-line comment or consecutive block of single-line comments as defined by the file's programming language as determined by its file extension.
+
+issue
+: A comment block with an issue marker and Markdown content.
+
+marker
+: A predefined keyword in all capitals that defines the semantics of the comment block in which it appears as the first word.
+
+provenance
+: Given an issue (and implicitly a Git history) the *provenance* of that issue is the pair of commits that first created that issue and that last modified that issue (within that Git history).
+
+tag
+: A word in pascal-case in a comment or an issue, outside code blocks or inline code, prefixed with `@`, and optionally associating with it the following word as its value.