docs: part 1 - fix warnings in documentation generation (#2861)

**Description**
This PR removes some of the warnings when uv builds the docs
- Errors appear when generating docs about .md files not appearing in
toctree. ~~Adding content to the `providers-gen.py ` file that adds `---
orphan: true ---` to to each file.~~. Added a toctree generator to the
`providers-gen.py` file, this gets rid of the errors in the builds.
- Deletes the `_openai_compat` files, extension of PR #2849
- Adds the `files` APIs section to the `providers` toctree on the index
page
- Manually adds the `--- orphan: true ---` to the advanced apis. Ill try
to find a way to modify the providers code gen so it automatically adds
it, but this fixes the errors.
- Adds the `testing.md` to the `contributing` toctree
- Adds `starting_llama_stack_server.md` to `distributions` toctree

There are some other warnings im still looking at but this PR gets rid
of most of the toctree errors
Theres also an issue with the actual distribution-codegen that I can
investigate in another PR. Opened a bug for it here #2873

docs/source/providers/inference/index.md

@@ -1,26 +1,34 @@
-# Inference Providers
+# Inference 
+
+## Overview
 
 This section contains documentation for all available providers for the **inference** API.
 
-- [inline::meta-reference](inline_meta-reference.md)
-- [inline::sentence-transformers](inline_sentence-transformers.md)
-- [remote::anthropic](remote_anthropic.md)
-- [remote::bedrock](remote_bedrock.md)
-- [remote::cerebras](remote_cerebras.md)
-- [remote::databricks](remote_databricks.md)
-- [remote::fireworks](remote_fireworks.md)
-- [remote::gemini](remote_gemini.md)
-- [remote::groq](remote_groq.md)
-- [remote::hf::endpoint](remote_hf_endpoint.md)
-- [remote::hf::serverless](remote_hf_serverless.md)
-- [remote::llama-openai-compat](remote_llama-openai-compat.md)
-- [remote::nvidia](remote_nvidia.md)
-- [remote::ollama](remote_ollama.md)
-- [remote::openai](remote_openai.md)
-- [remote::passthrough](remote_passthrough.md)
-- [remote::runpod](remote_runpod.md)
-- [remote::sambanova](remote_sambanova.md)
-- [remote::tgi](remote_tgi.md)
-- [remote::together](remote_together.md)
-- [remote::vllm](remote_vllm.md)
-- [remote::watsonx](remote_watsonx.md)
+## Providers
+
+```{toctree}
+:maxdepth: 1
+
+inline_meta-reference
+inline_sentence-transformers
+remote_anthropic
+remote_bedrock
+remote_cerebras
+remote_databricks
+remote_fireworks
+remote_gemini
+remote_groq
+remote_hf_endpoint
+remote_hf_serverless
+remote_llama-openai-compat
+remote_nvidia
+remote_ollama
+remote_openai
+remote_passthrough
+remote_runpod
+remote_sambanova
+remote_tgi
+remote_together
+remote_vllm
+remote_watsonx
+```