Always run the swag command to ensure fresh API documentation generation.

Co-authored-by: sreya <4856196+sreya@users.noreply.github.com>

Correct the bash line continuation syntax to match the original script.
The issue was double backslashes instead of single backslashes for line
continuation, which caused the swag command to fail.

The script now works correctly when run from the repository root.

Co-authored-by: sreya <4856196+sreya@users.noreply.github.com>

Remove custom OpenAPI parser and use a cleaner approach:
- Generate HTML documentation with Redocly CLI
- Convert HTML to markdown using turndown library
- Maintain compatibility with existing postprocessor

This approach:
- Uses Redocly's comprehensive HTML output (3.3MB)
- Converts to 959KB of markdown documentation
- Generates a single comprehensive API documentation file
- Leverages Redocly's excellent documentation generation
- Keeps the solution simple and maintainable

Co-authored-by: sreya <4856196+sreya@users.noreply.github.com>

Migrate from the unmaintained Widdershins to the actively maintained
OpenAPI Generator for generating API documentation markdown.

Changes:
- Replace @redocly/cli and turndown with @openapitools/openapi-generator-cli
- Use OpenAPI Generator's native markdown generator (beta)
- Add concat-markdown.js script to combine multiple files into single output
- Remove html-to-markdown.js (no longer needed)
- Update generate.sh to use OpenAPI Generator workflow

Results:
- Generates 22 comprehensive API documentation sections
- Produces 301KB of clean, structured markdown
- Uses actively maintained tooling with full OpenAPI 3.1 support
- Maintains compatibility with existing postprocessor
- Direct markdown generation (no HTML conversion needed)

The OpenAPI Generator provides excellent documentation quality while
being actively maintained by a large community, making it the ideal
long-term replacement for Widdershins.

Co-authored-by: sreya <4856196+sreya@users.noreply.github.com>