docs: fix broken links (#3540)

# What does this PR do?

<!-- Provide a short summary of what this PR does and why. Link to relevant issues if applicable. -->

<!-- If resolving an issue, uncomment and update the line below -->

<!-- Closes #[issue-number] -->

- Fixes broken links and Docusaurus search

Closes #3518

## Test Plan

The following should produce a clean build with no warnings and search enabled:

```
npm install
npm run gen-api-docs all
npm run build
npm run serve
```

<!-- Describe the tests you ran to verify your changes with result summaries. *Provide clear instructions so the plan can be easily re-executed.* -->

docs/docs/providers/agents/index.mdx

@@ -25,7 +25,3 @@ Agents API for creating and interacting with agentic systems.
     - Agents can also use Memory to retrieve information from knowledge bases. See the RAG Tool and Vector IO APIs for more details.
 
 This section contains documentation for all available providers for the **agents** API.
-
-## Providers
-
-- [Meta-Reference](./inline_meta-reference)

docs/docs/providers/batches/index.mdx

@@ -29,7 +29,3 @@ The Batches API enables efficient processing of multiple requests in a single op
     Note: This API is currently under active development and may undergo changes.
 
 This section contains documentation for all available providers for the **batches** API.
-
-## Providers
-
-- [Reference](./inline_reference)

docs/docs/providers/datasetio/index.md

@@ -1,16 +0,0 @@
----
-sidebar_label: Datasetio
-title: Datasetio
----
-
-# Datasetio
-
-## Overview
-
-This section contains documentation for all available providers for the **datasetio** API.
-
-## Providers
-
-- [Localfs](./inline_localfs)
-- [Remote - Huggingface](./remote_huggingface)
-- [Remote - Nvidia](./remote_nvidia)

docs/docs/providers/datasetio/index.mdx

@@ -8,9 +8,3 @@ title: Datasetio
 ## Overview
 
 This section contains documentation for all available providers for the **datasetio** API.
-
-## Providers
-
-- [Localfs](./inline_localfs)
-- [Remote - Huggingface](./remote_huggingface)
-- [Remote - Nvidia](./remote_nvidia)

docs/docs/providers/eval/index.mdx

@@ -11,8 +11,3 @@ title: Eval
 Llama Stack Evaluation API for running evaluations on model and agent candidates.
 
 This section contains documentation for all available providers for the **eval** API.
-
-## Providers
-
-- [Meta-Reference](./inline_meta-reference)
-- [Remote - Nvidia](./remote_nvidia)

docs/docs/providers/external/index.mdx

@@ -7,5 +7,5 @@ Llama Stack supports external providers that live outside of the main codebase.
 
 ## External Provider Documentation
 
-- [Known External Providers](external-providers-list)
-- [Creating External Providers](external-providers-guide)
+- [Known External Providers](./external-providers-list.mdx)
+- [Creating External Providers](./external-providers-guide.mdx)

docs/docs/providers/files/index.mdx

@@ -8,8 +8,3 @@ title: Files
 ## Overview
 
 This section contains documentation for all available providers for the **files** API.
-
-## Providers
-
-- [Localfs](./inline_localfs)
-- [Remote - S3](./remote_s3)

docs/docs/providers/index.mdx

@@ -21,13 +21,13 @@ Importantly, Llama Stack always strives to provide at least one fully inline pro
 
 ## Provider Categories
 
-- **[External Providers](./external/)** - Guide for building and using external providers
-- **[OpenAI Compatibility](./openai)** - OpenAI API compatibility layer
-- **[Inference](./inference/)** - LLM and embedding model providers
-- **[Agents](./agents/)** - Agentic system providers
-- **[DatasetIO](./datasetio/)** - Dataset and data loader providers
-- **[Safety](./safety/)** - Content moderation and safety providers
-- **[Telemetry](./telemetry/)** - Monitoring and observability providers
-- **[Vector IO](./vector-io/)** - Vector database providers
-- **[Tool Runtime](./tool-runtime/)** - Tool and protocol providers
-- **[Files](./files/)** - File system and storage providers
+- **[External Providers](external/index.mdx)** - Guide for building and using external providers
+- **[OpenAI Compatibility](./openai.mdx)** - OpenAI API compatibility layer
+- **[Inference](inference/index.mdx)** - LLM and embedding model providers
+- **[Agents](agents/index.mdx)** - Agentic system providers
+- **[DatasetIO](datasetio/index.mdx)** - Dataset and data loader providers
+- **[Safety](safety/index.mdx)** - Content moderation and safety providers
+- **[Telemetry](telemetry/index.mdx)** - Monitoring and observability providers
+- **[Vector IO](vector_io/index.mdx)** - Vector database providers
+- **[Tool Runtime](tool_runtime/index.mdx)** - Tool and protocol providers
+- **[Files](files/index.mdx)** - File system and storage providers

docs/docs/providers/inference/index.mdx

@@ -19,30 +19,3 @@ Llama Stack Inference API for generating completions, chat completions, and embe
     - Embedding models: these models generate embeddings to be used for semantic search.
 
 This section contains documentation for all available providers for the **inference** API.
-
-## Providers
-
-- [Meta-Reference](./inline_meta-reference)
-- [Sentence-Transformers](./inline_sentence-transformers)
-- [Remote - Anthropic](./remote_anthropic)
-- [Remote - Azure](./remote_azure)
-- [Remote - Bedrock](./remote_bedrock)
-- [Remote - Cerebras](./remote_cerebras)
-- [Remote - Databricks](./remote_databricks)
-- [Remote - Fireworks](./remote_fireworks)
-- [Remote - Gemini](./remote_gemini)
-- [Remote - Groq](./remote_groq)
-- [Remote - Hf - Endpoint](./remote_hf_endpoint)
-- [Remote - Hf - Serverless](./remote_hf_serverless)
-- [Remote - Llama-Openai-Compat](./remote_llama-openai-compat)
-- [Remote - Nvidia](./remote_nvidia)
-- [Remote - Ollama](./remote_ollama)
-- [Remote - Openai](./remote_openai)
-- [Remote - Passthrough](./remote_passthrough)
-- [Remote - Runpod](./remote_runpod)
-- [Remote - Sambanova](./remote_sambanova)
-- [Remote - Tgi](./remote_tgi)
-- [Remote - Together](./remote_together)
-- [Remote - Vertexai](./remote_vertexai)
-- [Remote - Vllm](./remote_vllm)
-- [Remote - Watsonx](./remote_watsonx)

docs/docs/providers/openai.mdx

@@ -1,3 +1,8 @@
+title: OpenAI Compatibility
+description: OpenAI API Compatibility
+sidebar_label: OpenAI Compatibility
+sidebar_position: 1
+---
 ## OpenAI API Compatibility
 
 ### Server path

docs/docs/providers/post_training/index.mdx

@@ -8,10 +8,3 @@ title: Post_Training
 ## Overview
 
 This section contains documentation for all available providers for the **post_training** API.
-
-## Providers
-
-- [Huggingface-Gpu](./inline_huggingface-gpu)
-- [Torchtune-Cpu](./inline_torchtune-cpu)
-- [Torchtune-Gpu](./inline_torchtune-gpu)
-- [Remote - Nvidia](./remote_nvidia)

docs/docs/providers/safety/index.mdx

@@ -8,12 +8,3 @@ title: Safety
 ## Overview
 
 This section contains documentation for all available providers for the **safety** API.
-
-## Providers
-
-- [Code-Scanner](./inline_code-scanner)
-- [Llama-Guard](./inline_llama-guard)
-- [Prompt-Guard](./inline_prompt-guard)
-- [Remote - Bedrock](./remote_bedrock)
-- [Remote - Nvidia](./remote_nvidia)
-- [Remote - Sambanova](./remote_sambanova)

docs/docs/providers/scoring/index.mdx

@@ -8,9 +8,3 @@ title: Scoring
 ## Overview
 
 This section contains documentation for all available providers for the **scoring** API.
-
-## Providers
-
-- [Basic](./inline_basic)
-- [Braintrust](./inline_braintrust)
-- [Llm-As-Judge](./inline_llm-as-judge)

docs/docs/providers/telemetry/index.mdx

@@ -8,7 +8,3 @@ title: Telemetry
 ## Overview
 
 This section contains documentation for all available providers for the **telemetry** API.
-
-## Providers
-
-- [Meta-Reference](./inline_meta-reference)

docs/docs/providers/tool_runtime/index.mdx

@@ -8,12 +8,3 @@ title: Tool_Runtime
 ## Overview
 
 This section contains documentation for all available providers for the **tool_runtime** API.
-
-## Providers
-
-- [Rag-Runtime](./inline_rag-runtime)
-- [Remote - Bing-Search](./remote_bing-search)
-- [Remote - Brave-Search](./remote_brave-search)
-- [Remote - Model-Context-Protocol](./remote_model-context-protocol)
-- [Remote - Tavily-Search](./remote_tavily-search)
-- [Remote - Wolfram-Alpha](./remote_wolfram-alpha)

docs/docs/providers/vector_io/index.mdx

@@ -8,18 +8,3 @@ title: Vector_Io
 ## Overview
 
 This section contains documentation for all available providers for the **vector_io** API.
-
-## Providers
-
-- [Chromadb](./inline_chromadb)
-- [Faiss](./inline_faiss)
-- [Meta-Reference](./inline_meta-reference)
-- [Milvus](./inline_milvus)
-- [Qdrant](./inline_qdrant)
-- [Sqlite-Vec](./inline_sqlite-vec)
-- [Sqlite Vec](./inline_sqlite_vec)
-- [Remote - Chromadb](./remote_chromadb)
-- [Remote - Milvus](./remote_milvus)
-- [Remote - Pgvector](./remote_pgvector)
-- [Remote - Qdrant](./remote_qdrant)
-- [Remote - Weaviate](./remote_weaviate)