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

Introduce Nodes APIs #521

Merged
merged 1 commit into from
May 19, 2022
Merged

Conversation

lukas-vlcek
Copy link
Contributor

Description

In this commit we are introducing a new section in REST API Reference for Nodes APIs.

We are adding documentation for "Nodes hot threads" and "Nodes info". Because Nodes APIs share common request parameters we also add more detailed section into parent index page (notice that the nodes-filter parameter was moved from "Cluster stats" page and was improved, and relevant links were updated).

There are more Nodes APIs that still need to be documented, this is just a good start.

We updated nav_order parameter for some pages as well.

Issues Resolved

There is meta-ticket: #424

Check List

  • Commits are signed per the DCO using --signoff

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

Signed-off-by: Lukáš Vlček [email protected]

In this commit we are introducing a new section in REST API Reference for Nodes APIs.

We are adding documentation for "Nodes hot threads" and "Nodes info". Because Nodes APIs share common request parameters we also add more detailed section into parent index page (notice that the nodes-filter parameter was moved from "Cluster stats" page and was improved, and relevant links were updated).

There are more Nodes APIs that still need to be documented, this is just a good start.

We updated nav_order parameter for some pages as well.

Relevant ticket: opensearch-project#424

Signed-off-by: Lukáš Vlček <[email protected]>
@lukas-vlcek lukas-vlcek requested a review from a team as a code owner April 22, 2022 16:43
@reta
Copy link
Contributor

reta commented May 3, 2022

@krisfreedain if you could help with pointing out right person / team to review, thank you

@krisfreedain
Copy link
Member

Thank you @lukas-vlcek @reta!

@Naarcha-AWS @natebower - I wanted to get this in front of you. Lukas and Andriy at Aiven have put in some work on the docs! Thanks.

@Naarcha-AWS
Copy link
Collaborator

@lukas-vlcek: I'll have this reviewed by EOD today.

@Naarcha-AWS Naarcha-AWS self-assigned this May 11, 2022
@lukas-vlcek
Copy link
Contributor Author

lukas-vlcek commented May 17, 2022

@Naarcha-AWS did you have a chance to look at it? I see that the PR got v2.0.0 label but let me just note that the content is valid for 1.x as well.

@Naarcha-AWS
Copy link
Collaborator

Naarcha-AWS commented May 18, 2022

Hi @lukas-vlcek. Sorry for the delay. I went ahead and added some style edits to this PR. They can be found here: #584.

@Naarcha-AWS Naarcha-AWS merged commit af40428 into opensearch-project:main May 19, 2022
@lukas-vlcek lukas-vlcek deleted the add_node_APIs branch May 19, 2022 15:56
@lukas-vlcek
Copy link
Contributor Author

lukas-vlcek commented May 19, 2022

Thanks for detailed review! 👍

@lukas-vlcek
Copy link
Contributor Author

lukas-vlcek commented May 20, 2022

@Naarcha-AWS I can see the online documentation has the "Nodes API" section now 👍 but it is missing sub-sections contained in this PR. Where did they go? Nodes info and Nodes hot threads. 😕

One nit picking though: Why did we change the "Nodes APIs" to singular "Nodes API" given it should have sub-sections?
So far the documentation uses plural for other sections containing sub-sections (e.g. Document APIs, Ingest APIs, Index APIs ...)

@lukas-vlcek
Copy link
Contributor Author

@Naarcha-AWS I pushed PR to fix this #592

@alicejw1 alicejw1 mentioned this pull request Dec 13, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants