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

[DOCS] Updates terms in anomaly detection job APIs #44839

Merged
merged 1 commit into from
Jul 25, 2019

Conversation

lcawl
Copy link
Contributor

@lcawl lcawl commented Jul 24, 2019

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.

@lcawl lcawl added >docs General docs changes :ml Machine learning v8.0.0 v7.4.0 v7.3.1 labels Jul 24, 2019
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-docs

@elasticmachine
Copy link
Collaborator

Pinging @elastic/ml-core

Copy link
Contributor

@droberts195 droberts195 left a 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
Copy link
Contributor

@droberts195 droberts195 Jul 25, 2019

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.

Copy link
Contributor Author

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

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