DOP-2742: Restore examples for io-code-block, input, and output directives in rstspec.toml (#387)

* DOP-2742: Restore examples for io-code-block, input, and output directives in rstspec.toml

* alter snippets to make more sense

* fix snippet

Co-authored-by: Grace Chong <[email protected]>

Author: gjchong25

snooty/rstspec.toml

@@ -471,14 +471,23 @@ options.caption = "string"
 options.copyable = "boolean"
 options.class = "string"
 options.source = "uri"
-# example = """.. io-code-block::
-#    ${2::copyable: (bool)
-#    :caption: (string)
-#    :class: (string)}
-#    :source: ${1: URL to source code}
-
-#    ${0:code input/code output content}
-# """
+example = """.. io-code-block::
+   ${2::copyable: (bool)
+   :caption: (string)
+   :class: (string)
+   :source: ${1: URL to source code}}
+
+   .. input:: ${0:code input or </path/to/file>}
+      :language: ${1:language}
+      :emphasize-lines: (string)
+      :linenos: (flag)
+
+   .. output:: ${0:code output or </path/to/file>}
+      :language: ${1:language}
+      :emphasize-lines: (string)
+      :linenos: (flag)
+      :visible: (bool)
+"""
 
 [directive.input]
 help = """The code content."""
@@ -487,12 +496,11 @@ content_type = "raw"
 options.language = "string"
 options.emphasize-lines = "linenos"
 options.linenos = "flag"
-# example = """.. io-code-block::
-#    .. input:: ${0:code output or </path/to/file>}
-#       :language: ${1:language}
-#       :emphasize-lines: (string)
-#       :linenos: (flag)
-# """
+example = """.. input:: ${0:code input or </path/to/file>}
+      :language: ${1:language}
+      :emphasize-lines: (string)
+      :linenos: (flag)
+"""
 
 [directive.output]
 help = """The code output."""
@@ -502,13 +510,12 @@ options.language = "string"
 options.emphasize-lines = "linenos"
 options.linenos = "flag"
 options.visible = "boolean"
-# example = """.. io-code-block::
-#    .. output:: ${0:code output or </path/to/file>}
-#       :language: ${1:language}
-#       :emphasize-lines: (string)
-#       :linenos: (flag)
-#       :visible: (bool)
-# """
+example = """.. output:: ${0:code output or </path/to/file>}
+      :language: ${1:language}
+      :emphasize-lines: (string)
+      :linenos: (flag)
+      :visible: (bool)
+"""
 
 [directive.cssclass]
 help = """Add the given CSS class name to generated HTML of the contained (if content is given) or