-
Notifications
You must be signed in to change notification settings - Fork 25.1k
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
[DOCS] Updates terms in anomaly detection job APIs #44839
Conversation
Pinging @elastic/es-docs |
Pinging @elastic/ml-core |
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.
LGTM
|
||
["source","java",subs="attributes,callouts,macros"] | ||
--------------------------------------------------- | ||
include-tagged::{doc-tests-file}[{api}-response] | ||
--------------------------------------------------- | ||
<1> whether was job deletion was acknowledged or not; will be `null` when set not to wait for completion | ||
<2> the id of the job deletion task; will be `null` when set to wait for completion | ||
<1> whether was job deletion was acknowledged or not; will be `null` when set |
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.
It's not a problem introduced by this PR, but there's a spurious "was" between "whether" and "job".
Also most of these callout notes begin with capital letters but <1>
and <2>
here don't.
And finally <2>
contains "id" in lowercase, and elsewhere you've been changing these to "ID" in uppercase.
Since the PR is green feel free to merge as-is and leave these typos for a future PR if you prefer.
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, @droberts195 I've put those fixes in #44865
Related to elastic/stack-docs#237
This PR updates the terminology in the Java REST Client and Elasticsearch Reference documentation such that it uses appropriate "anomaly detection job" terminology in the create, delete, open, and close job APIs.
NOTE: The Elasticsearch Reference has a separate "Machine learning anomaly detection APIs" section whereas the Java REST Client still just has a "Machine learning APIs" section. This might need to be rectified in the future. For now, I've altered the navigation titles in each book to reflect that difference.