docs: replace api build automation (#12214)

* remove-workflows-file-and-script

* tag-hidden-endpoints

* update-scripts-and-specs

* fix: nightly now properly gets 1.9.0 branch (#12215)

before it was attempting to pull release-notes as letters are alphanumerically after numbers when we sort -V then grab tail
now we only look at branch names that follow the pattern '^release-[0-9]+\.[0-9]+\.[0-9]+$'

* docs: add search icon (#12216)

add-back-svg

---------

Co-authored-by: Adam-Aghili <149833988+Adam-Aghili@users.noreply.github.com>
Co-authored-by: Debojit Kaushik <Kaushik.debojit@gmail.com>

docs/scripts/clean_openapi_formatting.py

@@ -1,73 +0,0 @@
-#!/usr/bin/env python3
-"""Clean OpenAPI specification formatting for better ReDoc display.
-
-This script converts newlines in descriptions to HTML breaks for proper
-rendering in ReDoc documentation.
-"""
-
-import json
-import sys
-from pathlib import Path
-
-MIN_ARGS = 2
-
-
-def clean_openapi_formatting(input_file: str, output_file: str | None = None) -> None:
-    """Clean OpenAPI spec formatting by converting newlines to HTML breaks.
-
-    Args:
-        input_file: Path to input OpenAPI JSON file
-        output_file: Path to output file (defaults to overwriting input)
-    """
-    if output_file is None:
-        output_file = input_file
-
-    try:
-        # Load the OpenAPI spec
-        input_path = Path(input_file)
-        with input_path.open(encoding="utf-8") as f:
-            spec = json.load(f)
-
-        # Fix description formatting by converting newlines to HTML breaks
-        if "paths" in spec:
-            for path_item in spec["paths"].values():
-                for operation in path_item.values():
-                    if isinstance(operation, dict) and "description" in operation:
-                        description = operation["description"]
-                        if description:
-                            # Convert newlines to HTML breaks for better ReDoc rendering
-                            operation["description"] = description.replace("\n", "<br>")
-
-        # Save the cleaned spec
-        output_path = Path(output_file)
-        with output_path.open("w", encoding="utf-8") as f:
-            json.dump(spec, f, indent=2, ensure_ascii=False)
-
-        # Success message (using sys.stdout for consistency)
-        sys.stdout.write(f"OpenAPI spec cleaned successfully: {output_file}\n")
-
-    except FileNotFoundError:
-        sys.stderr.write(f"Error: File not found: {input_file}\n")
-        sys.exit(1)
-    except json.JSONDecodeError as e:
-        sys.stderr.write(f"Error: Invalid JSON in {input_file}: {e}\n")
-        sys.exit(1)
-    except OSError as e:
-        sys.stderr.write(f"Error: {e}\n")
-        sys.exit(1)
-
-
-def main():
-    """Main entry point."""
-    if len(sys.argv) < MIN_ARGS:
-        sys.stderr.write("Usage: python clean_openapi_formatting.py <input_file> [output_file]\n")
-        sys.exit(1)
-
-    input_file = sys.argv[1]
-    output_file = sys.argv[2] if len(sys.argv) > MIN_ARGS else None
-
-    clean_openapi_formatting(input_file, output_file)
-
-
-if __name__ == "__main__":
-    main()