feat: add some descriptions

public/openapi/read.yaml

@@ -44,14 +44,21 @@ components:
       properties:
         loggedIn:
           type: boolean
+          description: true if user is logged in, false otherwise
         relative_path:
           type: string
+          description: |
+            if NodeBB is installed in a subfolder this becomes the path to the forum. For example if your forum url is
+            mycompany.com/community then relative_path will be /community. If your forum url is myforum.com then relative path will be empty string.
         url:
           type: string
+          description: base url of the current page, does not include query params
         bodyClass:
           type: string
+          description: the css class string that is appended to the body element
         _header:
           type: object
+          description: list of meta and link tags that are added to the head element
           properties:
             tags:
               type: object
@@ -95,8 +102,23 @@ components:
                       - type
                       - sizes
         widgets:
+          type: object
+          description: rendered widgets
+          properties:
+            header:
+              type: array
+              items:
                 type: object
                 properties:
+                  html:
+                    type: string
+            sidebar:
+              type: array
+              items:
+                type: object
+                properties:
+                  html:
+                    type: string
             footer:
               type: array
               items: