Skip to content

Conversation

@mikekistler
Copy link
Contributor

@mikekistler mikekistler commented Jan 16, 2025

This PR makes a batch of small improvements to the OpenAPI docs.

  • MaxLength and MinLength can work on arrays to set maxItems / minItems
  • Better TOC in the Customization page
  • Add section in Customization topic on the CreateReferenceId in OpenApiOptions
  • Add doc on multiple OpenApi documents

Each of these updates is made in its own commit in case you want to review them in isolation.


Internal previews

📄 File 🔗 Preview link
aspnetcore/fundamentals/openapi/aspnetcore-openapi.md aspnetcore/fundamentals/openapi/aspnetcore-openapi
aspnetcore/fundamentals/openapi/customize-openapi.md aspnetcore/fundamentals/openapi/customize-openapi
aspnetcore/fundamentals/openapi/include-metadata.md aspnetcore/fundamentals/openapi/include-metadata

Copy link
Member

@captainsafia captainsafia left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good overall! One small comment inline.

Copy link
Contributor

@tdykstra tdykstra left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, I noted just a few nits.

@mikekistler mikekistler merged commit 0e2adf1 into main Jan 16, 2025
3 checks passed
@mikekistler mikekistler deleted the mdk/openapi-improvements branch January 16, 2025 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants