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

[ Jekyll ] [ SpecInsert ] omit_header #8766

Merged
merged 6 commits into from
Nov 15, 2024

Conversation

nhtruong
Copy link
Contributor

Added omit_header argument for Spec Insert components along with minor refactoring to DRY the code base.

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

nhtruong and others added 5 commits November 15, 2024 09:59
A program that insert API Components generated from the OpenSearch OpenAPI Spec into markdown files

Signed-off-by: Theo Truong <theotr@amazon.com>
Signed-off-by: Theo Truong <theotr@amazon.com>
Signed-off-by: Theo Truong <theotr@amazon.com>
Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Daniel (dB.) Doubrovkine <dblock@dblock.org>
Signed-off-by: Theo N. Truong <theotr@amazon.com>
(Some minor refactoring to DRY the code as well)

Signed-off-by: Theo Truong <theotr@amazon.com>
Copy link

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Editorial review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference). The doc reviewer will arrange for an editorial review.

@@ -31,7 +32,7 @@ Edit your Markdown file and insert the following snippet where you want render a
<!-- spec_insert_start
api: <API_NAME>
component: <COMPONENT_NAME>
other_param: <OTHER_PARAM>
other_argument: <OTHER_ARGUMENT>
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Calling this argument to match what the code is actually using and avoid confusion with the API path and query params.

@nhtruong nhtruong requested a review from dblock November 15, 2024 17:07
@nhtruong nhtruong changed the title [Jekyll][SpecInsert] omit_header [ Jekyll ] [ SpecInsert ] omit_header Nov 15, 2024
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
@Naarcha-AWS Naarcha-AWS merged commit 70b7eef into opensearch-project:main Nov 15, 2024
7 checks passed
@nhtruong nhtruong deleted the omit_header branch November 15, 2024 18:53
@nhtruong nhtruong restored the omit_header branch November 15, 2024 18:53
@nhtruong nhtruong deleted the omit_header branch November 18, 2024 19:01
epugh pushed a commit to o19s/documentation-website that referenced this pull request Nov 23, 2024
* Spec Insert
A program that insert API Components generated from the OpenSearch OpenAPI Spec into markdown files

Signed-off-by: Theo Truong <theotr@amazon.com>

* # vale:reviewdog

Signed-off-by: Theo Truong <theotr@amazon.com>

* # Correction on cron job run time.

Signed-off-by: Theo Truong <theotr@amazon.com>

* Apply suggestions from code review

Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Daniel (dB.) Doubrovkine <dblock@dblock.org>
Signed-off-by: Theo N. Truong <theotr@amazon.com>

* Added `omit_header` argument for Spec Insert components
(Some minor refactoring to DRY the code as well)

Signed-off-by: Theo Truong <theotr@amazon.com>

* Apply suggestions from code review

Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

---------

Signed-off-by: Theo Truong <theotr@amazon.com>
Signed-off-by: Theo N. Truong <theotr@amazon.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Daniel (dB.) Doubrovkine <dblock@dblock.org>
Signed-off-by: Eric Pugh <epugh@opensourceconnections.com>
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.

3 participants