docs: fix warnings in documentation generation

docs/source/advanced_apis/eval/inline_meta-reference.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::meta-reference
 
 ## Description

docs/source/advanced_apis/eval/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/advanced_apis/post_training/inline_huggingface.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::huggingface
 
 ## Description

docs/source/advanced_apis/post_training/inline_torchtune.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::torchtune
 
 ## Description

docs/source/advanced_apis/post_training/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/advanced_apis/scoring/inline_basic.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::basic
 
 ## Description

docs/source/advanced_apis/scoring/inline_braintrust.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::braintrust
 
 ## Description

docs/source/advanced_apis/scoring/inline_llm-as-judge.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::llm-as-judge
 
 ## Description

docs/source/contributing/index.md

@@ -11,4 +11,5 @@ See the [Adding a New API Provider](new_api_provider.md) which describes how to
 :hidden:
 
 new_api_provider
+testing
 ```

docs/source/distributions/index.md

@@ -9,6 +9,7 @@ This section provides an overview of the distributions available in Llama Stack.
 list_of_distributions
 building_distro
 customizing_run_yaml
+starting_llama_stack_server
 importing_as_library
 configuration
 ```

docs/source/providers/agents/inline_meta-reference.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::meta-reference
 
 ## Description

docs/source/providers/datasetio/inline_localfs.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::localfs
 
 ## Description

docs/source/providers/datasetio/remote_huggingface.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::huggingface
 
 ## Description

docs/source/providers/datasetio/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/providers/eval/inline_meta-reference.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::meta-reference
 
 ## Description

docs/source/providers/eval/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/providers/files/inline_localfs.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::localfs
 
 ## Description

docs/source/providers/index.md

@@ -89,4 +89,14 @@ Is associated with the ToolGroup resources.
 :maxdepth: 1
 
 tool_runtime/index
-```
+```
+
+## Files Providers
+
+Is associated with the **files** APIs
+
+```{toctree}
+:maxdepth: 1
+
+files/index
+```

docs/source/providers/inference/inline_meta-reference.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::meta-reference
 
 ## Description

docs/source/providers/inference/inline_sentence-transformers.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::sentence-transformers
 
 ## Description

docs/source/providers/inference/remote_anthropic.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::anthropic
 
 ## Description

docs/source/providers/inference/remote_bedrock.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::bedrock
 
 ## Description

docs/source/providers/inference/remote_cerebras-openai-compat.md

@@ -1,21 +0,0 @@
-# remote::cerebras-openai-compat
-
-## Description
-
-Cerebras OpenAI-compatible provider for using Cerebras models with OpenAI API format.
-
-## Configuration
-
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `api_key` | `str \| None` | No |  | The Cerebras API key |
-| `openai_compat_api_base` | `<class 'str'>` | No | https://api.cerebras.ai/v1 | The URL for the Cerebras API server |
-
-## Sample Configuration
-
-```yaml
-openai_compat_api_base: https://api.cerebras.ai/v1
-api_key: ${env.CEREBRAS_API_KEY}
-
-```
-

docs/source/providers/inference/remote_cerebras.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::cerebras
 
 ## Description

docs/source/providers/inference/remote_databricks.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::databricks
 
 ## Description

docs/source/providers/inference/remote_fireworks-openai-compat.md

@@ -1,21 +0,0 @@
-# remote::fireworks-openai-compat
-
-## Description
-
-Fireworks AI OpenAI-compatible provider for using Fireworks models with OpenAI API format.
-
-## Configuration
-
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `api_key` | `str \| None` | No |  | The Fireworks API key |
-| `openai_compat_api_base` | `<class 'str'>` | No | https://api.fireworks.ai/inference/v1 | The URL for the Fireworks API server |
-
-## Sample Configuration
-
-```yaml
-openai_compat_api_base: https://api.fireworks.ai/inference/v1
-api_key: ${env.FIREWORKS_API_KEY}
-
-```
-

docs/source/providers/inference/remote_fireworks.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::fireworks
 
 ## Description

docs/source/providers/inference/remote_gemini.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::gemini
 
 ## Description

docs/source/providers/inference/remote_groq-openai-compat.md

@@ -1,21 +0,0 @@
-# remote::groq-openai-compat
-
-## Description
-
-Groq OpenAI-compatible provider for using Groq models with OpenAI API format.
-
-## Configuration
-
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `api_key` | `str \| None` | No |  | The Groq API key |
-| `openai_compat_api_base` | `<class 'str'>` | No | https://api.groq.com/openai/v1 | The URL for the Groq API server |
-
-## Sample Configuration
-
-```yaml
-openai_compat_api_base: https://api.groq.com/openai/v1
-api_key: ${env.GROQ_API_KEY}
-
-```
-

docs/source/providers/inference/remote_groq.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::groq
 
 ## Description

docs/source/providers/inference/remote_hf_endpoint.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::hf::endpoint
 
 ## Description

docs/source/providers/inference/remote_hf_serverless.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::hf::serverless
 
 ## Description

docs/source/providers/inference/remote_llama-openai-compat.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::llama-openai-compat
 
 ## Description

docs/source/providers/inference/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/providers/inference/remote_ollama.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::ollama
 
 ## Description

docs/source/providers/inference/remote_openai.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::openai
 
 ## Description

docs/source/providers/inference/remote_passthrough.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::passthrough
 
 ## Description

docs/source/providers/inference/remote_runpod.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::runpod
 
 ## Description

docs/source/providers/inference/remote_sambanova-openai-compat.md

@@ -1,21 +0,0 @@
-# remote::sambanova-openai-compat
-
-## Description
-
-SambaNova OpenAI-compatible provider for using SambaNova models with OpenAI API format.
-
-## Configuration
-
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `api_key` | `str \| None` | No |  | The SambaNova API key |
-| `openai_compat_api_base` | `<class 'str'>` | No | https://api.sambanova.ai/v1 | The URL for the SambaNova API server |
-
-## Sample Configuration
-
-```yaml
-openai_compat_api_base: https://api.sambanova.ai/v1
-api_key: ${env.SAMBANOVA_API_KEY}
-
-```
-

docs/source/providers/inference/remote_sambanova.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::sambanova
 
 ## Description

docs/source/providers/inference/remote_tgi.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::tgi
 
 ## Description

docs/source/providers/inference/remote_together-openai-compat.md

@@ -1,21 +0,0 @@
-# remote::together-openai-compat
-
-## Description
-
-Together AI OpenAI-compatible provider for using Together models with OpenAI API format.
-
-## Configuration
-
-| Field | Type | Required | Default | Description |
-|-------|------|----------|---------|-------------|
-| `api_key` | `str \| None` | No |  | The Together API key |
-| `openai_compat_api_base` | `<class 'str'>` | No | https://api.together.xyz/v1 | The URL for the Together API server |
-
-## Sample Configuration
-
-```yaml
-openai_compat_api_base: https://api.together.xyz/v1
-api_key: ${env.TOGETHER_API_KEY}
-
-```
-

docs/source/providers/inference/remote_together.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::together
 
 ## Description

docs/source/providers/inference/remote_vllm.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::vllm
 
 ## Description

docs/source/providers/inference/remote_watsonx.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::watsonx
 
 ## Description

docs/source/providers/post_training/inline_huggingface.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::huggingface
 
 ## Description

docs/source/providers/post_training/inline_torchtune.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::torchtune
 
 ## Description

docs/source/providers/post_training/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/providers/safety/inline_code-scanner.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::code-scanner
 
 ## Description

docs/source/providers/safety/inline_llama-guard.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::llama-guard
 
 ## Description

docs/source/providers/safety/inline_prompt-guard.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::prompt-guard
 
 ## Description

docs/source/providers/safety/remote_bedrock.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::bedrock
 
 ## Description

docs/source/providers/safety/remote_nvidia.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::nvidia
 
 ## Description

docs/source/providers/safety/remote_sambanova.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::sambanova
 
 ## Description

docs/source/providers/scoring/inline_basic.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::basic
 
 ## Description

docs/source/providers/scoring/inline_braintrust.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::braintrust
 
 ## Description

docs/source/providers/scoring/inline_llm-as-judge.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::llm-as-judge
 
 ## Description

docs/source/providers/telemetry/inline_meta-reference.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::meta-reference
 
 ## Description

docs/source/providers/tool_runtime/inline_rag-runtime.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::rag-runtime
 
 ## Description

docs/source/providers/tool_runtime/remote_bing-search.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::bing-search
 
 ## Description

docs/source/providers/tool_runtime/remote_brave-search.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::brave-search
 
 ## Description

docs/source/providers/tool_runtime/remote_model-context-protocol.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::model-context-protocol
 
 ## Description

docs/source/providers/tool_runtime/remote_tavily-search.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::tavily-search
 
 ## Description

docs/source/providers/tool_runtime/remote_wolfram-alpha.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::wolfram-alpha
 
 ## Description

docs/source/providers/vector_io/inline_chromadb.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::chromadb
 
 ## Description

docs/source/providers/vector_io/inline_faiss.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::faiss
 
 ## Description

docs/source/providers/vector_io/inline_meta-reference.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::meta-reference
 
 ## Description

docs/source/providers/vector_io/inline_milvus.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::milvus
 
 ## Description

docs/source/providers/vector_io/inline_qdrant.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::qdrant
 
 ## Description

docs/source/providers/vector_io/inline_sqlite-vec.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::sqlite-vec
 
 ## Description

docs/source/providers/vector_io/inline_sqlite_vec.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # inline::sqlite_vec
 
 ## Description

docs/source/providers/vector_io/remote_chromadb.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::chromadb
 
 ## Description

docs/source/providers/vector_io/remote_milvus.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::milvus
 
 ## Description

docs/source/providers/vector_io/remote_pgvector.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::pgvector
 
 ## Description

docs/source/providers/vector_io/remote_qdrant.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::qdrant
 
 ## Description

docs/source/providers/vector_io/remote_weaviate.md

@@ -1,3 +1,7 @@
+---
+orphan: true
+---
+
 # remote::weaviate
 
 ## Description

scripts/provider_codegen.py

@@ -145,6 +145,7 @@ def generate_provider_docs(provider_spec: Any, api_name: str) -> str:
     config_info = get_config_class_info(config_class)
 
     md_lines = []
+    md_lines.append("---\norphan: true\n---\n")
     md_lines.append(f"# {provider_type}")
     md_lines.append("")