Revert "docs: API docstrings cleanup for better documentation rendering (#3661)"

This reverts commit a8da6ba3a7.

docs/static/deprecated-llama-stack-spec.yaml

@@ -1033,8 +1033,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Inference
-      summary: List chat completions.
-      description: List chat completions.
+      summary: List all chat completions.
+      description: List all chat completions.
       parameters:
         - name: after
           in: query
@@ -1087,10 +1087,10 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Inference
-      summary: Create chat completions.
+      summary: >-
+        Generate an OpenAI-compatible chat completion for the given messages using
+        the specified model.
       description: >-
-        Create chat completions.
-
         Generate an OpenAI-compatible chat completion for the given messages using
         the specified model.
       parameters: []
@@ -1122,11 +1122,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Inference
-      summary: Get chat completion.
-      description: >-
-        Get chat completion.
-
-        Describe a chat completion by its ID.
+      summary: Describe a chat completion by its ID.
+      description: Describe a chat completion by its ID.
       parameters:
         - name: completion_id
           in: path
@@ -1156,10 +1153,10 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Inference
-      summary: Create completion.
+      summary: >-
+        Generate an OpenAI-compatible completion for the given prompt using the specified
+        model.
       description: >-
-        Create completion.
-
         Generate an OpenAI-compatible completion for the given prompt using the specified
         model.
       parameters: []
@@ -1192,10 +1189,10 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Inference
-      summary: Create embeddings.
+      summary: >-
+        Generate OpenAI-compatible embeddings for the given input using the specified
+        model.
       description: >-
-        Create embeddings.
-
         Generate OpenAI-compatible embeddings for the given input using the specified
         model.
       parameters: []
@@ -1228,10 +1225,9 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Files
-      summary: List files.
+      summary: >-
+        Returns a list of files that belong to the user's organization.
       description: >-
-        List files.
-
         Returns a list of files that belong to the user's organization.
       parameters:
         - name: after
@@ -1289,12 +1285,10 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Files
-      summary: Upload file.
-      description: >-
-        Upload file.
-
+      summary: >-
+        Upload a file that can be used across various endpoints.
+      description: >-
         Upload a file that can be used across various endpoints.
-
 
         The file upload should be a multipart form request with:
 
@@ -1344,10 +1338,9 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Files
-      summary: Retrieve file.
+      summary: >-
+        Returns information about a specific file.
       description: >-
-        Retrieve file.
-
         Returns information about a specific file.
       parameters:
         - name: file_id
@@ -1379,8 +1372,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Files
-      summary: Delete file.
-      description: Delete file.
+      summary: Delete a file.
+      description: Delete a file.
       parameters:
         - name: file_id
           in: path
@@ -1412,10 +1405,9 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Files
-      summary: Retrieve file content.
+      summary: >-
+        Returns the contents of the specified file.
       description: >-
-        Retrieve file content.
-
         Returns the contents of the specified file.
       parameters:
         - name: file_id
@@ -1472,10 +1464,9 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Safety
-      summary: Create moderation.
+      summary: >-
+        Classifies if text and/or image inputs are potentially harmful.
       description: >-
-        Create moderation.
-
         Classifies if text and/or image inputs are potentially harmful.
       parameters: []
       requestBody:
@@ -1506,8 +1497,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Agents
-      summary: List all responses.
-      description: List all responses.
+      summary: List all OpenAI responses.
+      description: List all OpenAI responses.
       parameters:
         - name: after
           in: query
@@ -1558,8 +1549,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Agents
-      summary: Create a model response.
-      description: Create a model response.
+      summary: Create a new OpenAI response.
+      description: Create a new OpenAI response.
       parameters: []
       requestBody:
         content:
@@ -1601,8 +1592,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Agents
-      summary: Get a model response.
-      description: Get a model response.
+      summary: Retrieve an OpenAI response by its ID.
+      description: Retrieve an OpenAI response by its ID.
       parameters:
         - name: response_id
           in: path
@@ -1632,8 +1623,8 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Agents
-      summary: Delete a response.
-      description: Delete a response.
+      summary: Delete an OpenAI response by its ID.
+      description: Delete an OpenAI response by its ID.
       parameters:
         - name: response_id
           in: path
@@ -1663,8 +1654,10 @@ paths:
           $ref: '#/components/responses/DefaultError'
       tags:
         - Agents
-      summary: List input items.
-      description: List input items.
+      summary: >-
+        List input items for a given OpenAI response.
+      description: >-
+        List input items for a given OpenAI response.
       parameters:
         - name: response_id
           in: path
@@ -10018,16 +10011,9 @@ tags:
     x-displayName: >-
       Llama Stack Evaluation API for running evaluations on model and agent candidates.
   - name: Files
-    description: >-
-      This API is used to upload documents that can be used with other Llama Stack
-      APIs.
-    x-displayName: Files
+    description: ''
   - name: Inference
     description: >-
-      Llama Stack Inference API for generating completions, chat completions, and
-      embeddings.
-
-
       This API provides the raw interface to the underlying models. Two kinds of models
       are supported:
 
@@ -10035,14 +10021,15 @@ tags:
 
       - Embedding models: these models generate embeddings to be used for semantic
       search.
-    x-displayName: Inference
+    x-displayName: >-
+      Llama Stack Inference API for generating completions, chat completions, and
+      embeddings.
   - name: Models
     description: ''
   - name: PostTraining (Coming Soon)
     description: ''
   - name: Safety
-    description: OpenAI-compatible Moderations API.
-    x-displayName: Safety
+    description: ''
   - name: Telemetry
     description: ''
   - name: VectorIO