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

Update PULL_REQUEST_TEMPLATE to include an API spec change in the checklist. #2808

Merged
merged 2 commits into from
Jul 29, 2024

Conversation

dblock
Copy link
Member

@dblock dblock commented Jul 8, 2024

Coming from opensearch-project/opensearch-api-specification#387, update PR template to include a checkbox that requests that all API changes be documented in the OpenAPI spec used to generate clients.

…cklist.

Signed-off-by: dblock <dblock@amazon.com>
derek-ho
derek-ho previously approved these changes Jul 9, 2024
- [ ] New functionality has been documented.
- [ ] New functionality has javadoc added
- [ ] New functionality has user manual doc added
Copy link
Member

@LantaoJin LantaoJin Jul 12, 2024

Choose a reason for hiding this comment

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

Could we keep these two sub-checkboxes? Or merge into one line such as

[ ] New functionality has been documented(javadoc, [user manual doc](https://github.com/opensearch-project/sql/blob/main/DEVELOPER_GUIDE.rst#reference-manual).

or

[ ] New functionality has been documented(javadoc, [user manual doc](https://github.com/opensearch-project/sql/tree/main/docs/user).

They are the actual items to explain what is New functionality has been documented meaning. It should be helpful to any new contributor.

Copy link
Member Author

Choose a reason for hiding this comment

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

I re-added those as they were before. The links will vary per branch, it's a different can of worms, leaving it to ya'll for a later improvement.

Signed-off-by: dblock <dblock@amazon.com>
@dai-chen dai-chen merged commit 6b8ee3d into opensearch-project:main Jul 29, 2024
14 checks passed
@dblock dblock deleted the update-pull-request-template branch July 30, 2024 17:34
manasvinibs pushed a commit to manasvinibs/sql that referenced this pull request Aug 14, 2024
…cklist. (opensearch-project#2808)

* Update PULL_REQUEST_TEMPLATE to include an API spec change in the checklist.

Signed-off-by: dblock <dblock@amazon.com>

* Re-added sections.

Signed-off-by: dblock <dblock@amazon.com>

---------

Signed-off-by: dblock <dblock@amazon.com>
jzonthemtn pushed a commit to jzonthemtn/sql that referenced this pull request Aug 28, 2024
…cklist. (opensearch-project#2808)

* Update PULL_REQUEST_TEMPLATE to include an API spec change in the checklist.

Signed-off-by: dblock <dblock@amazon.com>

* Re-added sections.

Signed-off-by: dblock <dblock@amazon.com>

---------

Signed-off-by: dblock <dblock@amazon.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.

5 participants