Improve oncall schedule endpoint documentation (#2812)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com> 2fedd1d

Author: api-clients-generation-pipeline[bot]

datadog_api_client.v2.model.html

@@ -81537,11 +81537,11 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">Shift</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span></dt>
 <dd><p>Bases: <a class="reference internal" href="datadog_api_client.html#datadog_api_client.model_utils.ModelNormal" title="datadog_api_client.model_utils.ModelNormal"><code class="xref py py-class docutils literal notranslate"><span class="pre">ModelNormal</span></code></a></p>
-<p>The definition of <code class="docutils literal notranslate"><span class="pre">Shift</span></code> object.</p>
+<p>An on-call shift with its associated data and relationships.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>data</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data.ShiftData" title="datadog_api_client.v2.model.shift_data.ShiftData"><em>ShiftData</em></a><em>, </em><em>optional</em>) – The definition of <code class="docutils literal notranslate"><span class="pre">ShiftData</span></code> object.</p></li>
+<li><p><strong>data</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data.ShiftData" title="datadog_api_client.v2.model.shift_data.ShiftData"><em>ShiftData</em></a><em>, </em><em>optional</em>) – Data for an on-call shift.</p></li>
 <li><p><strong>included</strong> (<em>[</em><a class="reference internal" href="#datadog_api_client.v2.model.shift_included.ShiftIncluded" title="datadog_api_client.v2.model.shift_included.ShiftIncluded"><em>ShiftIncluded</em></a><em>]</em><em>, </em><em>optional</em>) – The <code class="docutils literal notranslate"><span class="pre">Shift</span></code> <code class="docutils literal notranslate"><span class="pre">included</span></code>.</p></li>
 </ul>
 </dd>
@@ -81558,13 +81558,13 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">ShiftData</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span></dt>
 <dd><p>Bases: <a class="reference internal" href="datadog_api_client.html#datadog_api_client.model_utils.ModelNormal" title="datadog_api_client.model_utils.ModelNormal"><code class="xref py py-class docutils literal notranslate"><span class="pre">ModelNormal</span></code></a></p>
-<p>The definition of <code class="docutils literal notranslate"><span class="pre">ShiftData</span></code> object.</p>
+<p>Data for an on-call shift.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>attributes</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data_attributes.ShiftDataAttributes" title="datadog_api_client.v2.model.shift_data_attributes.ShiftDataAttributes"><em>ShiftDataAttributes</em></a><em>, </em><em>optional</em>) – The definition of <code class="docutils literal notranslate"><span class="pre">ShiftDataAttributes</span></code> object.</p></li>
+<li><p><strong>attributes</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data_attributes.ShiftDataAttributes" title="datadog_api_client.v2.model.shift_data_attributes.ShiftDataAttributes"><em>ShiftDataAttributes</em></a><em>, </em><em>optional</em>) – Attributes for an on-call shift.</p></li>
 <li><p><strong>id</strong> (<em>str</em><em>, </em><em>optional</em>) – The <code class="docutils literal notranslate"><span class="pre">ShiftData</span></code> <code class="docutils literal notranslate"><span class="pre">id</span></code>.</p></li>
-<li><p><strong>relationships</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data_relationships.ShiftDataRelationships" title="datadog_api_client.v2.model.shift_data_relationships.ShiftDataRelationships"><em>ShiftDataRelationships</em></a><em>, </em><em>optional</em>) – The definition of <code class="docutils literal notranslate"><span class="pre">ShiftDataRelationships</span></code> object.</p></li>
+<li><p><strong>relationships</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data_relationships.ShiftDataRelationships" title="datadog_api_client.v2.model.shift_data_relationships.ShiftDataRelationships"><em>ShiftDataRelationships</em></a><em>, </em><em>optional</em>) – Relationships for an on-call shift.</p></li>
 <li><p><strong>type</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data_type.ShiftDataType" title="datadog_api_client.v2.model.shift_data_type.ShiftDataType"><em>ShiftDataType</em></a>) – Indicates that the resource is of type ‘shifts’.</p></li>
 </ul>
 </dd>
@@ -81581,7 +81581,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">ShiftDataAttributes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span></dt>
 <dd><p>Bases: <a class="reference internal" href="datadog_api_client.html#datadog_api_client.model_utils.ModelNormal" title="datadog_api_client.model_utils.ModelNormal"><code class="xref py py-class docutils literal notranslate"><span class="pre">ModelNormal</span></code></a></p>
-<p>The definition of <code class="docutils literal notranslate"><span class="pre">ShiftDataAttributes</span></code> object.</p>
+<p>Attributes for an on-call shift.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -81602,7 +81602,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">ShiftDataRelationships</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span></dt>
 <dd><p>Bases: <a class="reference internal" href="datadog_api_client.html#datadog_api_client.model_utils.ModelNormal" title="datadog_api_client.model_utils.ModelNormal"><code class="xref py py-class docutils literal notranslate"><span class="pre">ModelNormal</span></code></a></p>
-<p>The definition of <code class="docutils literal notranslate"><span class="pre">ShiftDataRelationships</span></code> object.</p>
+<p>Relationships for an on-call shift.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>user</strong> (<a class="reference internal" href="#datadog_api_client.v2.model.shift_data_relationships_user.ShiftDataRelationshipsUser" title="datadog_api_client.v2.model.shift_data_relationships_user.ShiftDataRelationshipsUser"><em>ShiftDataRelationshipsUser</em></a><em>, </em><em>optional</em>) – Defines the relationship between a shift and the user who is working that shift.</p>
@@ -81721,7 +81721,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">ShiftIncluded</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span></dt>
 <dd><p>Bases: <a class="reference internal" href="datadog_api_client.html#datadog_api_client.model_utils.ModelComposed" title="datadog_api_client.model_utils.ModelComposed"><code class="xref py py-class docutils literal notranslate"><span class="pre">ModelComposed</span></code></a></p>
-<p>The definition of <code class="docutils literal notranslate"><span class="pre">ShiftIncluded</span></code> object.</p>
+<p>Included data for shift operations.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">