docs(API): document correct way of passing format_options (#1055)

Author: jablan

doc/compiled.json

@@ -9119,7 +9119,12 @@
                     "example": true
                   },
                   "format_options": {
-                    "description": "Additional formatting and render options. See the [format guide](https://support.phrase.com/hc/en-us/sections/6111343326364) for a list of options available for each format. Specify format options like this: `...&format_options[foo]=bar`",
+                    "description": "Additional formatting and render options. See the [format guide](https://support.phrase.com/hc/en-us/sections/6111343326364)\nfor a list of options available for each format. Pass format options as a JSON object with key-value pairs corresponding\nto the option name and value. For example, to include comments in a Gettext file, pass `{\"include_comments\": true}`.\n",
+                    "example": {
+                      "format_options": {
+                        "foo": "bar"
+                      }
+                    },
                     "type": "object",
                     "properties": {}
                   },

paths/locale_downloads/create.yaml

@@ -48,8 +48,13 @@ requestBody:
             type: boolean
             example: true
           format_options:
-            description: 'Additional formatting and render options. See the [format guide](https://support.phrase.com/hc/en-us/sections/6111343326364) for a list of options available for each format. Specify format options like this: `...&format_options[foo]=bar`'
-            # example:
+            description: |
+              Additional formatting and render options. See the [format guide](https://support.phrase.com/hc/en-us/sections/6111343326364)
+              for a list of options available for each format. Pass format options as a JSON object with key-value pairs corresponding
+              to the option name and value. For example, to include comments in a Gettext file, pass `{"include_comments": true}`.
+            example:
+              format_options:
+                foo: bar
             type: object
             properties: {}
           encoding: