[Doc] Improve API docs (#18713)

Signed-off-by: DarkLight1337 <[email protected]>

Author: DarkLight1337

docs/.nav.yml

@@ -18,7 +18,7 @@ nav:
       - Roadmap: https://roadmap.vllm.ai
       - Releases: https://github.com/vllm-project/vllm/releases
   - User Guide:
-    - usage/README.md
+    - Summary: usage/README.md
     - General:
       - usage/*
     - Inference and Serving:
@@ -44,7 +44,7 @@ nav:
       - features/*
       - features/quantization
   - Developer Guide:
-    - contributing/README.md
+    - Summary: contributing/README.md
     - General:
       - glob: contributing/*
         flatten_single_child_sections: true
@@ -53,9 +53,10 @@ nav:
       - V0: design
       - V1: design/v1
   - API Reference:
-    - api/README.md
-    - glob: api/vllm/*
-      preserve_directory_names: true
+    - Summary: api/README.md
+    - Contents:
+      - glob: api/vllm/*
+        preserve_directory_names: true
   - Community:
     - community/*
     - Blog: https://blog.vllm.ai

docs/mkdocs/stylesheets/extra.css

@@ -5,7 +5,7 @@
 }
 
 /* https://christianoliff.com/blog/styling-external-links-with-an-icon-in-css/ */
-a:not(:has(svg)):not(.md-icon) {
+a:not(:has(svg)):not(.md-icon):not(.autorefs-external) {
     align-items: center;
 
     &[href^="//"]::after,