Fix documentation link checker errors

[rahul-tuli]

Summary

Resolves 32 broken file links identified by the nightly link checker workflow that were causing CI failures.

Root Cause

The documentation had two categories of broken links:

1. Incorrect relative paths: Branding assets referenced from docs/developer/branding.md used relative paths that didn't account for the subdirectory structure
2. Missing directories: Links to non-existent API documentation and research sections

Changes

Fixed Branding Asset Links

• Updated all asset references in docs/developer/branding.md to use ../assets/branding/ instead of assets/branding/
• Fixed both the header logo display and the asset catalog table links
• All 26 branding assets (SVG/PNG files) exist but were incorrectly referenced

Removed Broken Directory Links

• Commented out API Reference section in docs/index.md until API docs are created
• Removed broken links to ./research/eagle3/ and ./research/hass/ directories
• Converted research section items to plain text descriptions

Validation

• All referenced branding assets verified to exist in docs/assets/branding/
• Link paths tested to ensure proper relative traversal from subdirectories
• Commented sections can be easily re-enabled when target directories are created

Impact

• Fixes nightly CI link checker failures
• Maintains documentation functionality while removing broken references
• Preserves future extensibility for API docs and research sections

[Copilot]

Pull Request Overview

This PR fixes broken documentation links that were causing CI failures in the nightly link checker workflow. The fixes address incorrect relative paths to branding assets and remove references to non-existent documentation directories.

• Updated relative paths for branding assets from assets/branding/ to ../assets/branding/
• Commented out the API Reference section until API documentation is created
• Converted broken research section links to plain text descriptions

Reviewed Changes

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

File	Description
docs/index.md	Commented out API Reference section and converted research links to plain text
docs/developer/branding.md	Fixed relative paths for all branding asset references

---

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

[github-actions]

📦 Build Artifacts Available
The build artifacts (`.whl` and `.tar.gz`) have been successfully generated and are available for download: https://github.com/vllm-project/speculators/actions/runs/17409603676/artifacts/3908217672.
They will be retained for up to 30 days.
Commit: bb6164c

[dsikka]

This doesn’t break our docs, does it?

[rahul-tuli]

This doesn’t break our docs, does it?

I will double check before requesting a review, this PR is Claude-generated!

[aireilly]

Maybe cleaner to set this in mkdocs.yml instead?

https://www.mkdocs.org/user-guide/configuration/#validation-of-absolute-links