all workign

Author: wxtim

cylc/sphinx_ext/cylc_lang/autodocumenters.py

@@ -482,31 +482,30 @@ def global_to_node(meta, src):
             if meta.get(settings, {}):
                 ret += [f'{INDENT}.. cylc:conf:: {settings}', '']
                 for regex, info in reversed(meta[settings].items()):
-                    task_meta = info.get('meta', {})
-                    title = task_meta.get('title', '')
+                    platform_meta = info.get('meta', {})
+                    title = platform_meta.get('title', '')
                     if not title:
                         title = regex
                     ret += [
                         f'{INDENT * 3}.. cylc:conf:: {title}', '',
-                        f'{INDENT * 4}.. admonition:: Key Details', '']
+                        f'{INDENT * 4}.. csv-table:: Key Details', '']
 
                     if title != regex:
-                        ret += [
-                            f'{INDENT * 5}Match ``{regex}`` to select these {settings}.',
-                            '']
+                        ret.append(f'{INDENT * 5}Regex, ``{regex}``.')
 
                     if info.get('job_runner'):
-                        ret += [
-                            f'{INDENT * 5}This platform uses job runner'
-                            f' ``{info.get("job_runner")}``', '']
-
-                    ret += [f'{INDENT * 5}Selects {selects} from:', '']
-    
-                    for selectable in info['select_from']:
-                        ret += [f'{INDENT * 5}* ``{selectable}``', '']
-
+                        ret.append(
+                            f'{INDENT * 5}job runner,'
+                            f' ``{info.get("job_runner")}``')
+
+                    selectables = '- ' + '\n- '.join(
+                        f'``{i}``' for i in info["select_from"])
+                    ret.append(f'{INDENT * 5}{selects},"{selectables}"')
+                    ret.append('')
+                    desc = platform_meta.get("description", "No description")
                     ret += [
-                        f'{INDENT * 4}{task_meta.get("description", "No description")}',
+                        f'{INDENT * 4}'
+                        f'{desc}',
                         '']
 
         [print(i) for i in ret]