Api-blueprint: Tidak dapat mereferensikan objek Struktur Data dalam array

Hai, terima kasih untuk produk yang luar biasa!

Saya mendokumentasikan menggunakan format JSONAPI, dan saya mengalami masalah dengan mengekspresikan objek dalam array. Ini diperlukan karena spesifikasi JSONAPI untuk hubungan ke-banyak yang tidak kosong.

Berikut ini contoh kode saya:

# Group Stock
All inventory information and management is exposed through the `stock` endpoint.

## Stock [/stock/{id}]

- Parameters
    - id: 1 (number, required) - Specific `id` of a stock item

- Attributes (Stock Base)
    - id: 1 (number) - Specific id of a stock item
    - type: stock (string) - Resource type

### Retireve Stock [GET]
Fetch details about specific stock.

- Response 200 (application/vnd.api+json)
    - Attributes (Stock)

## Stocks [/stock]

- Attributes
    - data(array[Stock]) - Full output of all data

### List all Stock [GET]
Return details of all stock.

- Response 200 (application/vnd.api+json)
    - Attributes (Stocks)

# Data Structures

## Stock Base (object)
- price: 4.50 (number) - Standard price
- sale_price: 3.00 (number) - Specific sale only price
- description: Coconut yoghurt (string) - Text description of stock item
- ingredients: Coconut, Nuts, Milk (string) - Comma separated list of all ingredients
- allergens: Nuts, dairy (string) - Comma separated list of all allergen information
- Include Stock Links Base

## Stock Links Base (object)
- links (object) - JSON API links section
    - *dietary_requirements* (array)
        - Include Linkage
    - *stock_type*
        - Include Linkage

## Linkage (object)
- linkage (object) - JSON API linkage section
    - id: 1 (number)
    - type: reference_type (string)

Jika Anda merender ini di tempat pemeliharaan lebah, Anda akan melihat bahwa array dietary_requirements kosong, meskipun itu merujuk ke Struktur Data Linkage .

Bantuan apa pun akan sangat dihargai.