update partials/api-resource.hbs

Author: mikewuu

src/layouts/partials/api-resource.hbs

@@ -1,8 +1,15 @@
 {{#if headingOffset}}
-### `{{name}}`
+### The {{name}} Object
 {{else}}
-## `{{name}}`
+## The {{name}} Object
 {{/if}}
+
+- [Properties](./#properties)
+- [Errors](./#errors)
+- [Warnings](./#warnings)
+- [Events](./#events)
+- [Endpoints](./#endpoints)
+
 {{#if description}}
 
 {{description}}
@@ -20,30 +27,49 @@
 {% endtabs %}
 {{/if}}
 
+{% tabs %}
+{% tab title="JSON" %}
+```json
+{
 {{#each properties}}
-{{#if ../headingOffset}}
-#### {{#if linkTarget}}[`{{name}}`]({{linkTarget}}){{else}}`{{name}}`{{/if}}
+{{#if @last}}
+  {{name}}: [example value]
 {{else}}
-### {{#if linkTarget}}[`{{name}}`]({{linkTarget}}){{else}}`{{name}}`{{/if}}
+  {{name}}: [example value],
 {{/if}}
-{{#if isDeprecated}}
+{{/each}}
+}
+```
+{% endtab %}
+{% endtabs %}
 
-{{> deprecated-warning}}
+---
+{{#if headingOffset}}
+### Properties
+{{else}}
+## Properties
 {{/if}}
 
-Format: `{{format}}`
-{{#if listItemFormat}}
+{{#each properties}}
+{{#if linkTarget}}[**`{{name}}`**]({{linkTarget}}){{else}}**`{{name}}`**{{/if}} *{{format}}*{{#if listItemFormat}} *of {{listItemFormat}}s*{{/if}}
 
-Item format: `{{listItemFormat}}`
-{{/if}}
 {{#if description}}
-
 {{description}}
 {{/if}}
-{{#if enumValues}}
 
-{{> enum-values}}
+{{#if isDeprecated}}
+{{> deprecated-warning}}
+{{/if}}
+
+{{#if enumValues}}
+<details>
+<summary>Enum values</summary>
+{{#each enumValues}}
+- `{{this}}`
+{{/each}}
+</details>
 {{/if}}
+
 {{#if value}}
 
 Value: `{{value}}`
@@ -53,11 +79,12 @@ Value: `{{value}}`
 
 This object has no properties.
 {{else}}
-{{#each objectProperties}}
-
-{{> property-collapsible this}}
-
-{{/each}}
+<details>
+  <summary>Child Properties</summary>
+  {{#each objectProperties}}
+  - {{> property-nested this}}
+  {{/each}}
+</details>
 {{/if}}
 {{/unless}}
 {{#if discriminatorVariants}}
@@ -74,8 +101,7 @@ Variants:
 {{/if}}
 {{#if this.properties.length}}
   {{#each this.properties}}
-
-{{> property-non-collapsible this isLast=@last}}
+  {{> property-non-collapsible this isLast=@last}}
   {{/each}}
 {{else}}
 
@@ -85,11 +111,12 @@ This variant has no additional specific properties.
   {{/each}}
 {{/if}}
 {{#if listProperties}}
-{{#each listProperties}}
-
-{{> property-collapsible this}}
-
-{{/each}}
+<details>
+  <summary>Child Object Properties</summary>
+  {{#each listProperties}}
+  {{> property-nested this}}
+  {{/each}}
+</details>
 {{/if}}
 
 ---