Skip to main content
Doctorine reference
On this pageOverview

A reference cycle was kept as-is

Cyclic $refs are preserved rather than inlined, which can reduce type fidelity in generated artifacts.

spec.refs.cycle-preserved

Category
API specification
Default severity
Warning
Applies to
API specification
Default outcome
Completed with warnings
Recommended action
Fix the source
Grouped by
Source location

Why it matters

Cyclic $refs are preserved rather than inlined, which can reduce type fidelity in generated artifacts.

How to fix it

  1. Break the $ref cycle by extracting a shared schema, if practical.
Documentation menu