Skip to content
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

Verbose Header Object documentation (3.0.4) #3867

Merged
merged 6 commits into from
Jun 10, 2024

Conversation

handrews
Copy link
Member

@handrews handrews commented May 30, 2024

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.

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.
@handrews handrews added clarification requests to clarify, but not change, part of the spec headers labels May 30, 2024
@handrews handrews added this to the v3.0.4 milestone May 30, 2024
@handrews handrews requested a review from a team May 30, 2024 20:20
...to placate the PR checks in GitHub.
Copy link
Contributor

@ralfhandl ralfhandl left a 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.

versions/3.0.4.md Outdated Show resolved Hide resolved
versions/3.0.4.md Outdated Show resolved Hide resolved
versions/3.0.4.md Outdated Show resolved Hide resolved
versions/3.0.4.md Show resolved Hide resolved
Copy link
Contributor

@lornajane lornajane left a 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.

versions/3.0.4.md Show resolved Hide resolved
versions/3.0.4.md Outdated Show resolved Hide resolved
versions/3.0.4.md Show resolved Hide resolved
Copy link
Contributor

@ralfhandl ralfhandl left a comment

Choose a reason for hiding this comment

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

Minor nit

versions/3.0.4.md Outdated Show resolved Hide resolved
miqui
miqui previously approved these changes Jun 7, 2024
Co-authored-by: Ralf Handl <[email protected]>
@ralfhandl ralfhandl requested a review from lornajane June 10, 2024 11:27
@handrews
Copy link
Member Author

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.

@handrews handrews merged commit 44eda57 into OAI:v3.0.4-dev Jun 10, 2024
1 check passed
@handrews handrews deleted the header-obj-304 branch June 10, 2024 17:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
clarification requests to clarify, but not change, part of the spec headers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants