From 5f02620a97c81a1a45acf57a107679bfcd26e86f Mon Sep 17 00:00:00 2001 From: thepetk Date: Sun, 2 Nov 2025 19:09:57 +0000 Subject: [PATCH] Support multi-line YAML formatting in index docs Signed-off-by: thepetk --- scripts/provider_codegen.py | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/scripts/provider_codegen.py b/scripts/provider_codegen.py index fcab50925..777f4f251 100755 --- a/scripts/provider_codegen.py +++ b/scripts/provider_codegen.py @@ -390,8 +390,16 @@ def generate_index_docs( # Add YAML frontmatter for index md_lines.append("---") if api_docstring: - clean_desc = api_docstring.strip().replace('"', '\\"') - md_lines.append(f'description: "{clean_desc}"') + # Handle multi-line descriptions in YAML + if "\n" in api_docstring.strip(): + md_lines.append("description: |") + for line in api_docstring.strip().split("\n"): + # Avoid trailing whitespace by only adding spaces to non-empty lines + md_lines.append(f" {line}" if line.strip() else "") + else: + # For single line descriptions, format properly for YAML + clean_desc = api_docstring.strip().replace('"', '\\"') + md_lines.append(f'description: "{clean_desc}"') md_lines.append(f"sidebar_label: {sidebar_label}") md_lines.append(f"title: {api_name.title()}") md_lines.append("---")