Add "Simulation Setup" section

Author: dwhswenson

paths_cli/cli.py

@@ -61,7 +61,8 @@ def get_command(self, ctx, name):
         return self._get_command.get(name)
 
     def format_commands(self, ctx, formatter):
-        sec_order = ['Simulation', 'Analysis', 'Miscellaneous', 'Workflow']
+        sec_order = ["Simulation Setup", 'Simulation', 'Analysis',
+                     'Miscellaneous', 'Workflow']
         for sec in sec_order:
             cmds = self._sections.get(sec, [])
             rows = []

paths_cli/commands/compile.py

@@ -95,7 +95,7 @@ def compile_(input_file, output_file):
 
 PLUGIN = OPSCommandPlugin(
     command=compile_,
-    section="Miscellaneous",
+    section="Simulation Setup",
     requires_ops=(1, 0),
     requires_cli=(0, 3)
 )

paths_cli/compiling/_gendocs/docs_generator.py

@@ -54,7 +54,7 @@ def generate_category_rst(self, category_plugin):
         rst = f".. _compiling--{category_plugin.label}:\n\n"
         rst += f"{cat_info.header}\n{'=' * len(str(cat_info.header))}\n\n"
         if cat_info.description:
-            rst += cat_info.description + "\n\n"
+            rst += cat_info.description + "The following types are available:\n\n"
         rst += ".. contents:: :local:\n\n"
         for obj in category_plugin.type_dispatch.values():
             rst += self.generate_plugin_rst(