docs: tweak the minimal syntax diagram

It now uses a simpler layout for the optional empty paths, and the type is explicitly optional.
h4l · Aug 9, 2023 · 921b6b7 · 921b6b7
1 parent 396e59b
commit 921b6b7
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 16 deletions.
diff --git a/docs/syntax-diagrams/jb_arg_syntax_diagrams.py b/docs/syntax-diagrams/jb_arg_syntax_diagrams.py
@@ -160,10 +160,10 @@ def argument() -> DiagramItem:
 
 def minimal_arg() -> DiagramItem:
     """A high-level summary of the argument structure."""
-    return OptionalSequence(
-        NonTerminal("key"),
-        Sequence(":", NonTerminal("type")),
-        Sequence(Choice(0, "=", "@"), NonTerminal("value")),
+    return Sequence(
+        Optional(NonTerminal("key")),
+        Choice(0, Sequence(":", Optional(NonTerminal("type"))), Skip()),
+        Optional(Sequence(Choice(0, "=", "@"), NonTerminal("value"))),
     )
 
 

diff --git a/docs/syntax-diagrams/minimal-argument.svg b/docs/syntax-diagrams/minimal-argument.svg