Array description guideline

[PedroDiez]

What type of PR is this?

• documentation

What this PR does / why we need it:

This PR manages the cases when a response or specific field is an array so as their description is well renderized.

It applies for #547:

• For request scenarios guideline already exists 5.7.5. Request Bodies

• For response scenarios this PR adds a guideline in section 5.8.2. Responses

Which issue(s) this PR fixes:

Fixes #547

Does this PR introduce a breaking change?

• Yes
• No

Special notes for reviewers:

Changelog input

 guideline for array descriptions

Additional documentation

This section can be blank.

docs

[rartych]

Case B shows the property items referencing a schema that itself is an array. That results in an array-of-arrays, maybe this would be sufficient:

```yaml
components:
  schemas:
    <schema-name>:
      type: object
      properties:
        <property-name>:
            $ref: "#/components/schemas/<schema-item-name>"
...
    <schema-item-name>:
      type: array
      items:
        type: string
        description: <description>

[PedroDiez]

Case B shows the property items referencing a schema that itself is an array. That results in an array-of-arrays, maybe this would be sufficient:

```yaml
components:
  schemas:
    <schema-name>:
      type: object
      properties:
        <property-name>:
            $ref: "#/components/schemas/<schema-item-name>"
...
    <schema-item-name>:
      type: array
      items:
        type: string
        description: <description>

Yes, i agree. Thanks for the catch-up. Will also name to <schema-array-name>