feat(docs): add GEO infrastructure for AI search visibility

[Borda]

This pull request introduces major improvements to the documentation and publishing workflow for the Supervision library. The most significant updates include enhanced SEO and discoverability features, such as structured metadata, Open Graph and Twitter Card tags, and root files for search engines and LLMs. Additionally, the documentation content has been expanded with new descriptions and an improved introduction, and the publishing workflow now injects essential files into the gh-pages branch.

SEO and discoverability enhancements:

• Added JSON-LD structured data for organization, software, tech articles, and breadcrumbs, as well as Open Graph and Twitter Card meta tags to docs/theme/main.html for improved SEO and social sharing.
• Added robots.txt to allow all major bots and provide a sitemap, and added llms.txt with a summary, install instructions, key APIs, and links for LLM discoverability. [1] [2]
• Updated the GitHub Actions workflow (.github/workflows/publish-docs.yml) to automatically inject robots.txt and llms.txt into the gh-pages branch on publish.

Documentation content improvements:

• Added or updated description metadata to all major documentation pages for better search engine indexing and richer link previews. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Homepage and introduction updates:

• Added a new "What is Supervision?" section to the homepage (docs/index.md) with a concise library overview, key features, and community adoption metrics.

These changes collectively make the documentation more discoverable, easier to understand for new users, and ready for integration with search engines and LLMs.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77%. Comparing base (6069c47) to head (511a2f3).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff           @@
##           develop   #2224   +/-   ##
=======================================
  Coverage       77%     77%           
=======================================
  Files           66      66           
  Lines         8211    8211           
=======================================
  Hits          6350    6350           
  Misses        1861    1861           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

This PR enhances Supervision’s documentation discoverability by adding SEO/“GEO” metadata, LLM-friendly root files, and a publishing workflow step to place those root files on gh-pages.

Changes:

• Add JSON-LD structured data plus Open Graph/Twitter Card meta tags to the MkDocs theme.
• Introduce robots.txt and llms.txt, and update the docs publish workflow to inject them into the gh-pages root.
• Add per-page description front matter across key docs pages and expand the homepage introduction.

Reviewed changes

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

Show a summary per file

File	Description
docs/trackers.md	Adds page description metadata for SEO snippets.
docs/theme/main.html	Injects JSON-LD + Open Graph/Twitter meta tags in the MkDocs theme.
docs/robots.txt	Adds crawler directives and a sitemap reference (see review comments).
docs/llms.txt	Adds LLM-oriented project summary, key APIs, and links.
docs/index.md	Adds homepage description and a “What is Supervision?” intro section.
docs/how_to/track_objects.md	Adds page description metadata.
docs/how_to/save_detections.md	Adds page description metadata.
docs/how_to/process_datasets.md	Adds page description metadata.
docs/how_to/filter_detections.md	Adds page description metadata.
docs/how_to/detect_small_objects.md	Adds page description metadata.
docs/how_to/detect_and_annotate.md	Adds page description metadata.
docs/how_to/count_in_zone.md	Adds front matter with description metadata.
docs/how_to/benchmark_a_model.md	Adds page description metadata.
docs/detection/core.md	Adds page description metadata.
docs/detection/annotators.md	Adds page description metadata.
docs/datasets/core.md	Adds page description metadata.
docs/changelog.md	Adds page description metadata.
.github/workflows/publish-docs.yml	Injects robots.txt and llms.txt into gh-pages root after deployment.