From f76518a8b610efb26c8faedbcbf4b963cd492f03 Mon Sep 17 00:00:00 2001
From: Radon Rosborough <radon.neon@gmail.com>
Date: Sat, 13 Mar 2021 10:55:29 -0800
Subject: [PATCH] Work on JSON Schema docstrings

---
 tools/jsonschema.yaml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/tools/jsonschema.yaml b/tools/jsonschema.yaml
index bba6589..dac9c91 100644
--- a/tools/jsonschema.yaml
+++ b/tools/jsonschema.yaml
@@ -403,9 +403,39 @@ properties:
             anyOf:
               # TODO: fill in documentation
               - const: assembly
+                description: |
+                  A language that uses assembly syntax of some kind,
+                  characterized by sequential, atomic statements
+                  without advanced control flow.
+                examples:
+                  - "x86"
+                  - "riscv"
+                  - "jasmin"
               - const: basic
+                description: |
+                  A language that uses BASIC-derived syntax,
+                  characterized by a lack of syntactic control
+                  characters and (often) uppercase keywords.
+                examples:
+                  - cmd
+                  - cobol
               - const: c
+                description: |
+                  A language that uses C-derived syntax, characterized
+                  by ubiquitous curly braces and semicolons for
+                  control flow scoping.
+                examples:
+                  - objectivec
+                  - java
               - const: golf
+                description: |
+                  A language that uses syntax remniscent of code
+                  golfing, characterized by single-letter or otherwise
+                  very short commands and control flow syntax.
+                examples:
+                  - befunge
+                  - fishlang
+                  - apl
               - const: haskell
               - const: lisp
               - const: pascal