update fields

Author: ethanpalm

components/fields.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Fields"
 description: "Set parameters for your API or SDK references"
-icon: 'letter-text'
+icon: "letter-text"
 ---
 
 Use fields to document API parameters and responses. There are two types of fields: parameter fields and response fields.
@@ -14,72 +14,56 @@ The `<ParamField>` component is used to define parameters for your APIs or SDKs.
   An example of a parameter field
 </ParamField>
 
-<RequestExample>
-
-```mdx Path Example
-<ParamField path="param" type="string">
+```mdx
+<ParamField path="param" type="string" required>
   An example of a parameter field
 </ParamField>
 ```
 
-```mdx Body Example
-<ParamField body="user_age" type="integer" default="0" required>
-  The age of the user. Cannot be less than 0
-</ParamField>
-```
-
-```mdx Response Example
-<ResponseField name="response" type="string" required>
-  A response field example
-</ResponseField>
-```
-
-</RequestExample>
-
 ### Properties
 
 <ParamField body="query, path, body, or header" type="string">
-  Whether it is a query, path, body, or header parameter followed by the name
+  Whether the parameter is a query, path, body, or header. Followed by the parameter name.
 </ParamField>
 
 <ParamField body="type" type="string">
-  Expected type of the parameter's value
+  Expected type of the parameter's value.
 
-  Supports `number`, `string`, `bool`, `object`.
+  Supports `number`, `string`, `boolean`, `object`.
 
   Arrays can be defined using the `[]` suffix. For example, `string[]`.
 </ParamField>
 
 <ParamField body="required" type="boolean">
-  Indicate whether the parameter is required
+  Indicate whether the parameter is required.
 </ParamField>
 
 <ParamField body="deprecated" type="boolean">
-  Indicate whether the parameter is deprecated
+  Indicate whether the parameter is deprecated.
 </ParamField>
 
 <ParamField body="default" type="string">
-  Default value used by the server if the request does not provide a value
+  Default value used by the server if the request does not provide a value.
 </ParamField>
 
 <ParamField body="initialValue" type="any">
-  Value that will be used to initialize the playground
+  Value that will be used to initialize the playground.
 </ParamField>
 
 <ParamField body="placeholder" type="string">
-  Placeholder text for the input in the playground
+  Placeholder text for the input in the playground.
 </ParamField>
 
 <ParamField body="children" type="string">
-  Description of the parameter (markdown enabled)
+  Description of the parameter (Markdown-enabled).
 </ParamField>
 
 ## Response field
 
-The `<ResponseField>` component defines the return values of an API. Many docs also use `<ResponseField>` on pages when you need to list the types of something.
+The `<ResponseField>` component defines the return values of an API.
 
 <ResponseField name="response" type="string" required>
-  A response field example
+  An example of a response field
 </ResponseField>
 
 ```mdx
@@ -91,29 +75,29 @@ The `<ResponseField>` component defines the return values of an API. Many docs a
 ### Properties
 
 <ResponseField name="name" type="string" required>
-  The name of the response value
+  The name of the response value.
 </ResponseField>
 
 <ResponseField name="type" type="string" required>
   Expected type of the response value. This can be any arbitrary string.
 </ResponseField>
 
 <ResponseField name="default" type="string">
-  The default value
+  The default value.
 </ResponseField>
 
 <ResponseField name="required" type="boolean">
-  Show "required" beside the field name
+  Indicate whether the response is required.
 </ResponseField>
 
 <ResponseField name="deprecated" type="boolean">
-  Whether a field is deprecated
+  Whether a field is deprecated.
 </ResponseField>
 
 <ResponseField name="pre" type="string[]">
-  Labels that are shown before the name of the field
+  Labels that are shown before the name of the field.
 </ResponseField>
 
 <ResponseField name="post" type="string[]">
-  Labels that are shown after the name of the field
+  Labels that are shown after the name of the field.
 </ResponseField>