added more docs

source/api_definitions.py

@@ -550,30 +550,7 @@ if __name__ == "__main__":
             info=Info(
                 title="[DRAFT] Llama Stack Specification",
                 version="0.0.1",
-                description="""Meta has built out a fairly sophisticated platform internally to post train, evaluate, and 
+                description="""This is the specification of the llama stack that provides 
-                serve Llama models to support Meta’s products. Given the newer capabilities of the llama models, 
-                the model development and model serving capabilities of the platform need to be enhanced in 
-                specific ways in order to best leverage the models. For example, the inference platform needs 
-                to support code execution to take advantage of the built-in knowledge of tools of the model. 
-                The largest models are of high enough quality to be used to generate synthetic data or be used 
-                as reward models. There are specific fine tuning and quantization techniques that we have found 
-                result in the best performing Llama models. We would like to share ways in which an LLM Ops 
-                toolchain can be designed by leveraging our learnings in getting Llama models to power Meta’s products.
-                <br>
-                In addition, the Llama 3 models Meta will release in July should not just be seen as a model, but 
-                really as a system starting the transition towards an entity capable of performing "agentic" tasks 
-                which require the ability to act as the central planner and break a task down and perform multi-step 
-                reasoning and call tools for specific operations. In addition, there needs to be general model-level 
-                safety checks as well as task-specific safety checks that are performed at a system level. 
-                <br>
-                We are defining the Llama Stack as a set of APIs and standards by synthesizing our learnings while 
-                working with Llama models. The APIs are divided into the llama-toolchain-api and the llama-agentic-system-api. 
-                These APIs provide a coherent way for model developers to fine tune and serve Llama models, and agentic app 
-                developers to leverage all the capabilities of the Llama models seamlessly. We would like to work with the 
-                ecosystem to enhance and simplify the API. In addition, we will be releasing a plug-in architecture to allow 
-                creating distributions of the llama stack with different implementations.
-                <br>
-                This is the specification of the llama stack that provides 
                 a set of endpoints and their corresponding interfaces that are tailored to 
                 best leverage Llama Models. The specification is still in draft and subject to change.""",
             ),

source/openapi.html

@@ -21,7 +21,7 @@
     "info": {
         "title": "[DRAFT] Llama Stack Specification",
         "version": "0.0.1",
-        "description": "Meta has built out a fairly sophisticated platform internally to post train, evaluate, and \n                serve Llama models to support Meta’s products. Given the newer capabilities of the llama models, \n                the model development and model serving capabilities of the platform need to be enhanced in \n                specific ways in order to best leverage the models. For example, the inference platform needs \n                to support code execution to take advantage of the built-in knowledge of tools of the model. \n                The largest models are of high enough quality to be used to generate synthetic data or be used \n                as reward models. There are specific fine tuning and quantization techniques that we have found \n                result in the best performing Llama models. We would like to share ways in which an LLM Ops \n                toolchain can be designed by leveraging our learnings in getting Llama models to power Meta’s products.\n                <br>\n                In addition, the Llama 3 models Meta will release in July should not just be seen as a model, but \n                really as a system starting the transition towards an entity capable of performing \"agentic\" tasks \n                which require the ability to act as the central planner and break a task down and perform multi-step \n                reasoning and call tools for specific operations. In addition, there needs to be general model-level \n                safety checks as well as task-specific safety checks that are performed at a system level. \n                <br>\n                We are defining the Llama Stack as a set of APIs and standards by synthesizing our learnings while \n                working with Llama models. The APIs are divided into the llama-toolchain-api and the llama-agentic-system-api. \n                These APIs provide a coherent way for model developers to fine tune and serve Llama models, and agentic app \n                developers to leverage all the capabilities of the Llama models seamlessly. We would like to work with the \n                ecosystem to enhance and simplify the API. In addition, we will be releasing a plug-in architecture to allow \n                creating distributions of the llama stack with different implementations.\n                <br>\n                This is the specification of the llama stack that provides \n                a set of endpoints and their corresponding interfaces that are tailored to \n                best leverage Llama Models. The specification is still in draft and subject to change."
+        "description": "This is the specification of the llama stack that provides \n                a set of endpoints and their corresponding interfaces that are tailored to \n                best leverage Llama Models. The specification is still in draft and subject to change."
     },
     "servers": [
         {
@@ -3331,6 +3331,9 @@
         }
     ],
     "tags": [
+        {
+            "name": "Datasets"
+        },
         {
             "name": "SyntheticDataGeneration"
         },
@@ -3340,15 +3343,12 @@
         {
             "name": "MemoryBanks"
         },
-        {
-            "name": "AgenticSystem"
-        },
-        {
-            "name": "Datasets"
-        },
         {
             "name": "RewardScoring"
         },
+        {
+            "name": "AgenticSystem"
+        },
         {
             "name": "PostTraining"
         },

source/openapi.yaml

@@ -1502,40 +1502,10 @@ components:
       pattern: ^(https?://|file://|data:)
       type: string
 info:
-  description: "Meta has built out a fairly sophisticated platform internally to post\
+  description: "This is the specification of the llama stack that provides \n    \
-    \ train, evaluate, and \n                serve Llama models to support Meta’s\
+    \            a set of endpoints and their corresponding interfaces that are tailored\
-    \ products. Given the newer capabilities of the llama models, \n             \
+    \ to \n                best leverage Llama Models. The specification is still\
-    \   the model development and model serving capabilities of the platform need\
+    \ in draft and subject to change."
-    \ to be enhanced in \n                specific ways in order to best leverage\
-    \ the models. For example, the inference platform needs \n                to support\
-    \ code execution to take advantage of the built-in knowledge of tools of the model.\
-    \ \n                The largest models are of high enough quality to be used to\
-    \ generate synthetic data or be used \n                as reward models. There\
-    \ are specific fine tuning and quantization techniques that we have found \n \
-    \               result in the best performing Llama models. We would like to share\
-    \ ways in which an LLM Ops \n                toolchain can be designed by leveraging\
-    \ our learnings in getting Llama models to power Meta’s products.\n          \
-    \      <br>\n                In addition, the Llama 3 models Meta will release\
-    \ in July should not just be seen as a model, but \n                really as\
-    \ a system starting the transition towards an entity capable of performing \"\
-    agentic\" tasks \n                which require the ability to act as the central\
-    \ planner and break a task down and perform multi-step \n                reasoning\
-    \ and call tools for specific operations. In addition, there needs to be general\
-    \ model-level \n                safety checks as well as task-specific safety\
-    \ checks that are performed at a system level. \n                <br>\n      \
-    \          We are defining the Llama Stack as a set of APIs and standards by synthesizing\
-    \ our learnings while \n                working with Llama models. The APIs are\
-    \ divided into the llama-toolchain-api and the llama-agentic-system-api. \n  \
-    \              These APIs provide a coherent way for model developers to fine\
-    \ tune and serve Llama models, and agentic app \n                developers to\
-    \ leverage all the capabilities of the Llama models seamlessly. We would like\
-    \ to work with the \n                ecosystem to enhance and simplify the API.\
-    \ In addition, we will be releasing a plug-in architecture to allow \n       \
-    \         creating distributions of the llama stack with different implementations.\n\
-    \                <br>\n                This is the specification of the llama\
-    \ stack that provides \n                a set of endpoints and their corresponding\
-    \ interfaces that are tailored to \n                best leverage Llama Models.\
-    \ The specification is still in draft and subject to change."
   title: '[DRAFT] Llama Stack Specification'
   version: 0.0.1
 jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema
@@ -2053,12 +2023,12 @@ security:
 servers:
 - url: http://any-hosted-llama-stack.com
 tags:
+- name: Datasets
 - name: SyntheticDataGeneration
 - name: Inference
 - name: MemoryBanks
-- name: AgenticSystem
-- name: Datasets
 - name: RewardScoring
+- name: AgenticSystem
 - name: PostTraining
 - description: <SchemaDefinition schemaRef="#/components/schemas/ShieldConfig" />
   name: ShieldConfig