Skip to content

OpenAPI spec lint errors detected #2297

@github-actions

Description

@github-actions

OpenAPI Lint Errors

The vacuum linter found errors in QuantConnect-Platform-2.0.0.yaml.

Category Errors Warnings Info
Operations 0 8 0
Tags 0 269 0
Schemas 54 173 2
Descriptions 0 37 322
Examples 0 166 0

Run: https://github.com/QuantConnect/Documentation/actions/runs/24205466213

Steps to fix

  1. Install vacuum locally:
  2. Run vacuum to get the detailed error report:
    vacuum lint QuantConnect-Platform-2.0.0.yaml --fail-severity error
    
  3. Fix each error in QuantConnect-Platform-2.0.0.yaml. Common issues:
    • oas3-schema: Using nullable: true (OpenAPI 3.0 style) instead of type: [string, "null"] (OpenAPI 3.1 style).
    • oas-schema-check: Fields listed in required that don't exist in properties, or invalid type values (e.g. type: int instead of type: integer).
  4. Re-run vacuum to confirm no errors remain:
    vacuum lint QuantConnect-Platform-2.0.0.yaml --fail-severity error
    
  5. Regenerate the API reference pages:
    python code-generators/API-Reference-Code-Generator.py
    

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions