-
Notifications
You must be signed in to change notification settings - Fork 9.1k
Verbose Header Object documentation (3.0.4) #3867
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
This copies the relevant Parameter Object fields to the Header Object instead of relying on implicit guidance. The text for the fields has been edited to reflect that only headers are being described. This also include an example of describing a header using the `content` field, and explaining why it is necessary to do so.
...to placate the PR checks in GitHub.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the diligence!
Only minor suggestions.
Co-authored-by: Ralf Handl <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
More information is good information IMO, thank you for this addition.
Co-authored-by: Ralf Handl <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Minor nit
Co-authored-by: Ralf Handl <[email protected]>
This has two TSC approvals and a third positive-comment-with-questions-that-have-been-resolved near-approval so I'm going to merge this to start to reduce the amount of conflicts with empty sections and the like. |
Fixes:
This copies the relevant Parameter Object fields to the Header Object instead of relying on implicit guidance. The text for the fields has been edited to reflect that only headers are being described.
This also include an example of describing a header using the
content
field, and explaining why it is necessary to do so.NOTE: Includes some appendix headings to placate the PR markdown validation check.