remove empty and unimplemented sections

src/docs/render_block.js

@@ -1,4 +1,4 @@
-import { capitalize, trim } from 'lodash-es'
+import { trim } from 'lodash-es'
 
 import renderFields from './render_block_fields.js'
 import renderInputs from './render_block_inputs.js'
@@ -21,12 +21,42 @@ This Block requires an IO+ subscription to use. [Learn more about IO+](https://i
 
   renderIOPlusAlert = ({ ioPlus }) => ioPlus ? IO_PLUS_ALERT : "",
 
+  renderFieldsSection = definition => {
+    const fieldsMarkdown = renderFields(definition)
+
+    return fieldsMarkdown
+     ? `## Fields\n\n${ fieldsMarkdown }`
+     : ""
+  },
+
+  renderInputsSection = definition => {
+    const inputsMarkdown = renderInputs(definition)
+
+    return inputsMarkdown
+     ? `## Inputs\n\n${ inputsMarkdown }`
+     : ""
+  },
+
   renderOutput = definition => {
-    return capitalize(definition.connections?.output || "Unspecified")
+    return ''
+
+    // TODO: re-enable when we have something meanginful to show the user
+    // const defaultedOutput = capitalize(definition.connections?.output || "Unspecified")
+
+    // return `
+    //   ## Output
+    //   ${ defaultedOutput }
+    // `
   },
 
   renderExamples = definition => {
-    return "Coming soon..."
+    return ""
+
+    // TODO: re-enable conditionally when we have examples
+    // return `
+    //   ## Examples
+    //   Coming soon...
+    // `
   }
 
 export default definition =>
@@ -44,15 +74,11 @@ ${ renderDescription(definition) }
 
 ${ renderIOPlusAlert(definition) }
 
-## Fields
+${ renderFieldsSection(definition) }
-${ renderFields(definition) }
 
-## Inputs
+${ renderInputsSection(definition) }
-${ renderInputs(definition) }
 
-## Output
 ${ renderOutput(definition) }
 
-## Examples
 ${ renderExamples(definition) }
 `

src/docs/render_block_fields.js

@@ -14,7 +14,7 @@ const
       return newField
     }))
 
-    if(!fields.length) { return "This block has no form fields." }
+    if(!fields.length) { return }
 
     return fields.map(renderField).join("\n\n")
   },

src/docs/render_block_inputs.js

@@ -9,9 +9,7 @@ const
       return renderOverridenInputs(definition)
     }
 
-    if(!keys(definition.inputs).length) {
+    if(!keys(definition.inputs).length) { return }
-      return "This block has no inputs"
-    }
 
     return renderEachInput(definition)
   },