Add build-time OpenAPI generation doc #33359
Conversation
| uid: fundamentals/openapi/buildtime-openapi | ||
| --- | ||
|
|
||
| # Generate OpenAPI documents at build-time |
There was a problem hiding this comment.
@Rick-Anderson @tdykstra This definitely needs some massaging for prose and formatting but the material covered is true to what I think we should cover. Feel free to modify this branch as you see fit.
There was a problem hiding this comment.
@Rick-Anderson @tdykstra This definitely needs some massaging for prose and formatting but the material covered is true to what I think we should cover. Feel free to modify this branch as you see fit.
Can I merge #33361 into this branch? You've reviewed #33361 and @mikekistler has approved my changes. My PR fixes the toc.yml merge conflict. I think I can easily fix the other merge conflicts.
Rick-Anderson
changed the title
captainsafia
force-pushed
the
openapi-build-docs
branch
from
2698d41 to
2f05a5a
Compare
|
OK! I've rebased this PR and resolved the merge conflicts. @mikekistler We talked about doing another revamp on the Table of Contents alongside this change. Are you OK with merging this PR and making the Table of Contents change in another one? Alternatively, if we want the ToC to stay in a nice state we can fix it here. |
mikekistler
left a comment
mikekistler
left a comment
There was a problem hiding this comment.
I'm fine to defer the TOC revamp to a later PR as long as that doesn't force us to add redirects for ephemeral pages added here.
captainsafia
changed the title
|
@Rick-Anderson @tdykstra Can I get another content review before we merge this? |
tdykstra
left a comment
tdykstra
left a comment
There was a problem hiding this comment.
Looks good, I noted just a few minor issues.
Co-authored-by: Tom Dykstra <[email protected]>
|
I'm gonna go ahead and merge this so we can iterate on the ToC and content in future PRs. |
EDIT by @Rick-Anderson
All commit and suggestions should be made in #33361
#33361 will merge into this PR
----------- END of edit -----------
Adding a new page to document our build-time OpenAPI document generation capabilities.
Internal previews