Feature/5 workflow for publishing docs

[jathavaan]

No description provided.

[Copilot]

Pull Request Overview

This PR adds a GitHub Actions workflow for publishing documentation to GitHub Pages with versioned releases. The workflow is triggered on version tags and allows manual dispatch for publishing schema documentation.

• Adds a new workflow for publishing docs with proper permissions and version handling
• Updates documentation deployment to use cp instead of rsync for better compatibility
• Creates a landing page with automatic redirect to the main schema documentation

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
.github/workflows/publish-docs.yml	New workflow for publishing versioned docs to GitHub Pages with permissions and deployment configuration
.github/workflows/deploy-schema-gh-pages.yml	Adds automatic redirect landing page creation for better user experience

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Removing the trailing slash from the destination path may cause generate-schema-doc to create files differently than expected. The original site/$VERSION/ indicates the destination should be treated as a directory, while site/$VERSION could be interpreted as a file. This could lead to incorrect file placement or generation errors.

Suggested change

	generate-schema-doc schema/ site/$VERSION \
	generate-schema-doc schema/ site/$VERSION/ \

[Copilot]

The meta refresh redirect is vulnerable to open redirect attacks if the URL parameter can be manipulated. Consider using a more secure redirect method or validating that the target URL is safe and internal to the site.