[DOCS] Updates terms in machine learning calendar APIs (#44866)

Author: lcawl

docs/java-rest/high-level/ml/delete-calendar-event.asciidoc

@@ -4,13 +4,13 @@
 :response: AcknowledgedResponse
 --
 [id="{upid}-{api}"]
-=== Delete Calendar Event API
+=== Delete calendar event API
 Removes a scheduled event from an existing {ml} calendar.
 The API accepts a +{request}+ and responds
 with a +{response}+ object.
 
 [id="{upid}-{api}-request"]
-==== Delete Calendar Event Request
+==== Delete calendar event request
 
 A +{request}+ is constructed referencing a non-null
 calendar ID, and eventId which to remove from the calendar
@@ -23,7 +23,7 @@ include-tagged::{doc-tests-file}[{api}-request]
 <2> The eventId to remove from the calendar
 
 [id="{upid}-{api}-response"]
-====  Delete Calendar Event Response
+====  Delete calendar event response
 
 The returned +{response}+ acknowledges the success of the request:
 

docs/java-rest/high-level/ml/delete-calendar-job.asciidoc

@@ -4,13 +4,13 @@
 :response: PutCalendarResponse
 --
 [id="{upid}-{api}"]
-=== Delete Calendar Job API
-Removes {ml} jobs from an existing {ml} calendar.
+=== Delete {anomaly-jobs} from calendar API
+Removes {anomaly-jobs} from an existing {ml} calendar.
 The API accepts a +{request}+ and responds
 with a +{response}+ object.
 
 [id="{upid}-{api}-request"]
-==== Delete Calendar Job Request
+==== Delete {anomaly-jobs} from calendar request
 
 A +{request}+ is constructed referencing a non-null
 calendar ID, and JobIDs which to remove from the calendar
@@ -23,14 +23,14 @@ include-tagged::{doc-tests-file}[{api}-request]
 <2> The JobIds to remove from the calendar
 
 [id="{upid}-{api}-response"]
-====  Delete Calendar Job Response
+====  Delete {anomaly-jobs} from calendar response
 
 The returned +{response}+ contains the updated Calendar:
 
 ["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------
 include-tagged::{doc-tests-file}[{api}-response]
 --------------------------------------------------
-<1> The updated Calendar with the jobs removed
+<1> The updated calendar with the jobs removed
 
 include::../execution.asciidoc[]

docs/java-rest/high-level/ml/delete-calendar.asciidoc

@@ -4,24 +4,24 @@
 :response: AcknowledgedResponse
 --
 [id="{upid}-{api}"]
-=== Delete Calendar API
+=== Delete calendar API
 Delete a {ml} calendar.
 The API accepts a +{request}+ and responds
 with a +{response}+ object.
 
 [id="{upid}-{api}-request"]
-==== Delete Calendar Request
+==== Delete calendar request
 
 A `DeleteCalendar` object requires a non-null `calendarId`.
 
 ["source","java",subs="attributes,callouts,macros"]
 ---------------------------------------------------
 include-tagged::{doc-tests-file}[{api}-request]
 ---------------------------------------------------
-<1> Constructing a new request referencing an existing Calendar
+<1> Constructing a new request referencing an existing calendar
 
 [id="{upid}-{api}-response"]
-==== Delete Calendar Response
+==== Delete calendar response
 
 The returned +{response}+ object indicates the acknowledgement of the request:
 ["source","java",subs="attributes,callouts,macros"]

docs/java-rest/high-level/ml/put-calendar-job.asciidoc

@@ -4,13 +4,13 @@
 :response: PutCalendarResponse
 --
 [id="{upid}-{api}"]
-=== Put Calendar Job API
-Adds {ml} jobs to an existing {ml} calendar.
+=== Put {anomaly-jobs} in calendar API
+Adds {anomaly-jobs} jobs to an existing {ml} calendar.
 The API accepts a +{request}+ and responds
 with a +{response}+ object.
 
 [id="{upid}-{api}-request"]
-==== Put Calendar Job Request
+==== Put {anomaly-jobs} in calendar request
 
 A +{request}+ is constructed referencing a non-null
 calendar ID, and JobIDs to which to add to the calendar
@@ -23,14 +23,14 @@ include-tagged::{doc-tests-file}[{api}-request]
 <2> The JobIds to add to the calendar
 
 [id="{upid}-{api}-response"]
-==== Put Calendar Response
+==== Put {anomaly-jobs} in calendar response
 
-The returned +{response}+ contains the updated Calendar:
+The returned +{response}+ contains the updated calendar:
 
 ["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------
 include-tagged::{doc-tests-file}[{api}-response]
 --------------------------------------------------
-<1> The updated Calendar
+<1> The updated calendar
 
 include::../execution.asciidoc[]

docs/java-rest/high-level/ml/put-calendar.asciidoc

@@ -4,32 +4,32 @@
 :response: PutCalendarResponse
 --
 [id="{upid}-{api}"]
-=== Put Calendar API
+=== Put calendar API
 Creates a new {ml} calendar.
 The API accepts a +{request}+ and responds
 with a +{response}+ object.
 
 [id="{upid}-{api}-request"]
-==== Put Calendar Request
+==== Put calendar request
 
-A +{request}+ is constructed with a Calendar object
+A +{request}+ is constructed with a calendar object
 
 ["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------
 include-tagged::{doc-tests-file}[{api}-request]
 --------------------------------------------------
-<1> Create a request with the given Calendar
+<1> Create a request with the given calendar.
 
 
 [id="{upid}-{api}-response"]
 ==== Put Calendar Response
 
-The returned +{response}+ contains the created Calendar:
+The returned +{response}+ contains the created calendar:
 
 ["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------
 include-tagged::{doc-tests-file}[{api}-response]
 --------------------------------------------------
-<1> The created Calendar
+<1> The created calendar.
 
 include::../execution.asciidoc[]

docs/reference/ml/anomaly-detection/apis/delete-calendar-job.asciidoc

@@ -1,34 +1,34 @@
 [role="xpack"]
 [testenv="platinum"]
 [[ml-delete-calendar-job]]
-=== Delete jobs from calendar API
+=== Delete {anomaly-jobs} from calendar API
 ++++
 <titleabbrev>Delete jobs from calendar</titleabbrev>
 ++++
 
-Deletes jobs from a calendar.
+Deletes {anomaly-jobs} from a calendar.
 
 [[ml-delete-calendar-job-request]]
 ==== {api-request-title}
 
 `DELETE _ml/calendars/<calendar_id>/jobs/<job_id>`
 
-[[ml-delete-calendar-job-path-parms]]
-==== {api-path-parms-title}
-
-`calendar_id`(required)::
-  (string) Identifier for the calendar.
-
-`job_id` (required)::
-  (string) An identifier for the job. It can be a job identifier, a group name, or a
-           comma-separated list of jobs or groups.
-
 [[ml-delete-calendar-job-prereqs]]
 ==== {api-prereq-title}
 
-You must have `manage_ml`, or `manage` cluster privileges to use this API.
+* You must have `manage_ml`, or `manage` cluster privileges to use this API.
 For more information, see {stack-ov}/security-privileges.html[Security privileges].
 
+[[ml-delete-calendar-job-path-parms]]
+==== {api-path-parms-title}
+
+`<calendar_id>`::
+  (Required, string) Identifier for the calendar.
+
+`<job_id>`::
+  (Required, string) An identifier for the {anomaly-jobs}. It can be a job
+  identifier, a group name, or a comma-separated list of jobs or groups.
+
 [[ml-delete-calendar-job-example]]
 ==== {api-examples-title}
 

docs/reference/ml/anomaly-detection/apis/put-calendar-job.asciidoc

@@ -1,35 +1,36 @@
 [role="xpack"]
 [testenv="platinum"]
 [[ml-put-calendar-job]]
-=== Add jobs to calendar API
+=== Add {anomaly-jobs} to calendar API
 ++++
 <titleabbrev>Add jobs to calendar</titleabbrev>
 ++++
 
-Adds a job to a calendar.
+Adds an {anomaly-job} to a calendar.
 
 [[ml-put-calendar-job-request]]
 ==== {api-request-title}
 
 `PUT _ml/calendars/<calendar_id>/jobs/<job_id>`
 
-[[ml-put-calendar-job-path-parms]]
-==== {api-path-parms-title}
-
-`calendar_id` (required)::
-  (string) Identifier for the calendar.
-
-`job_id` (required)::
-  (string) An identifier for the job. It can be a job identifier, a group name, or a
-           comma-separated list of jobs or groups.
 
 [[ml-put-calendar-job-prereqs]]
 ==== {api-prereq-title}
 
-You must have `manage_ml`, or `manage` cluster privileges to use this API.
+* You must have `manage_ml`, or `manage` cluster privileges to use this API.
 For more information, see
 {stack-ov}/security-privileges.html[Security Privileges].
 
+[[ml-put-calendar-job-path-parms]]
+==== {api-path-parms-title}
+
+`<calendar_id>`::
+  (Required, string) Identifier for the calendar.
+
+`<job_id>`::
+  (Required, string) An identifier for the {anomaly-jobs}. It can be a job
+  identifier, a group name, or a comma-separated list of jobs or groups.
+
 [[ml-put-calendar-job-example]]
 ==== {api-examples-title}