Small documentation updates

jdi-testing · Aug 29, 2024 · 00cfb6b · 00cfb6b
1 parent 0c74acb
commit 00cfb6b
Show file tree

Hide file tree

Showing 6 changed files with 1,375 additions and 2 deletions.
diff --git a/app/models.py b/app/models.py
@@ -67,7 +67,13 @@ class PredictedElement(BaseModel):
 
 
 class PredictionResponseModel(RootModel):
-    root: List[PredictedElement]
+    root: List[PredictedElement] = Field(
+        description=(
+            "List of page elements predicted by model. Is a subset of elements passed in the input. "
+            "This means that if an element is present on the web page, but was not passed in the request's "
+            "`elements` parameter, it will not be analysed by model."
+        ),
+    )
 
 
 class Attachment(BaseModel):
@@ -98,7 +104,10 @@ class PredictionRequest(BaseModel):
         description=(
             "Full HTML document for analysis. "
             "Every element should have jdn-hash attribute, which value must be unique "
-            "across the document and should be unique across documents."
+            "across the document and should be unique across documents. If an element "
+            "is not assigned with the have jdn-hash attribute, it will not be possible "
+            "to refer to that element in `elements` array and model analysis will not be "
+            "performed for this element."
         ),
         example=(
             "<html lang=\"en\" jdn-hash=\"111111\">"
@@ -111,6 +120,7 @@ class PredictionRequest(BaseModel):
         default="[]",
         description=(
             "JSON dumped to string, containing list of elements on page with some info about them.\n\n"
+            "This elements will be then analyzed by a model. List should contain at least one object.\n\n"
             "Documentation for objects fields. Sometimes JS code is used to describe values. In this case `el` will "
             "be used to refer to page element.\n\n"
             "`tag_name`: Tag name of the element, uppercased. `el.tagName`\n\n"

diff --git a/asyncapi.yaml b/asyncapi.yaml
@@ -176,6 +176,7 @@ components:
           default: null
           description: >-
             Maximum amount of seconds which should be spent to find XPath expression for one element.
+            No limits are applied if the value is `null`.
           example: 10
         allow_indexes_at_the_beginning:
           type: boolean

diff --git a/docs/css/asyncapi.min.css b/docs/css/asyncapi.min.css
diff --git a/docs/css/global.min.css b/docs/css/global.min.css
@@ -0,0 +1 @@
+html{-moz-tab-size:4;-o-tab-size:4;tab-size:4;line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0;font-family:system-ui,-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji}
diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/js/asyncapi-ui.min.js b/docs/js/asyncapi-ui.min.js