dev: Remove old README, update docs

[deaneeth]

Removes the outdated README file and updates the documentation. This change cleans up the project by removing redundant files and ensuring the documentation is current.

[Copilot]

Pull request overview

This pull request replaces the markdown-based documentation (docs/index.md) with a new interactive HTML documentation site. However, the scope extends significantly beyond what's described in the PR title and description. The changes introduce a full-featured web application with AI integration capabilities, external service dependencies, and unfortunately, several critical security issues.

Key Changes:

• Removes the existing technical documentation (docs/index.md) which contained installation instructions, ISA reference, and examples
• Adds a 1,773-line interactive HTML documentation site with live demos, dark mode, and visualizations
• Introduces AI-powered features via Gemini API integration through a Cloudflare Worker proxy
• Critical: Commits a .env file containing an exposed API key to the repository

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
docs/index.md	Complete removal of existing markdown documentation including ISA reference and setup instructions
docs/index.html	New interactive documentation site with embedded JavaScript (1773 lines), live demos, and AI features
docs/cloudflare-worker.js	API proxy for Gemini AI with CORS configuration and request handling
docs/.nojekyll	Jekyll disable marker for GitHub Pages
.env	CRITICAL SECURITY ISSUE: Contains exposed Gemini API key that should never be committed

Comments suppressed due to low confidence (2)

docs/index.md:1

• The entire docs/index.md file is being deleted, which contained important technical documentation including:

• Installation instructions
• Complete instruction set reference table
• Example runners and file paths
• Publishing and contributing guidelines

While the new HTML documentation (docs/index.html) is visually appealing and interactive, it appears to be more of a project retrospective/showcase rather than comprehensive technical documentation. Important information like the complete ISA reference and detailed setup instructions may be missing from the new documentation.

Consider either:

1. Keeping the markdown documentation alongside the HTML for different audiences (developers vs. general visitors)
2. Ensuring all critical technical information from the markdown is preserved in the new HTML documentation
3. Creating a separate technical documentation section in the new HTML file

The PR description states "removes the outdated README file" but this is actually the documentation index, not a README (the actual README.md exists at the root).
docs/index.md:1

• The PR description states this change "Removes the outdated README file", but this is not a README file - it's the documentation index file (docs/index.md). The actual README.md file is at the root of the repository and is not being modified in this PR.

Additionally, the PR description says it "updates the documentation" but doesn't mention:

1. The addition of a new interactive HTML documentation site
2. The addition of a Cloudflare Worker for API proxying
3. The addition of a .env file with an API key (which is a security concern)

The PR description undersells the scope of these changes. Consider updating it to accurately reflect that this is a major documentation overhaul that introduces new interactive features and external service dependencies.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.