<commit_before>{% macro paramList(params, truncateLines) -%}
  {%- if params -%}
    ({%- for param in params -%}
      {$ param | escape | truncateCode(truncateLines) $}{% if not loop.last %}, {% endif %}
    {%- endfor %})
  {%- endif %}
{%- endmacro -%}


{% macro returnType(returnType) -%}
  {%- if returnType %}: {$ returnType | escape $}{% endif -%}
{%- endmacro -%}

{%- macro renderParameters(parameters, containerClass, parameterClass, showType) -%}
{%- if parameters.length -%}
<table class="is-full-width list-table parameters-table {$ containerClass $}">
  <tbody>
  {% for parameter in parameters %}
    <tr class="{$ parameterClass $}">
      <td class="param-name"><a id="{$ parameter.anchor $}"></a>{$ parameter.name $}</td>
      {% if showType %}<td class="param-type"><code>{$ parameter.type $}</code></td>{% endif %}
      <td class="param-description">
      {% marked %}
      {% if parameter.description | trim %}{$ parameter.description $}

      {% elseif not showType and parameter.type %}<p>Type: <code>{$ parameter.type $}</code>.</p>
      {% endif %}

      {% if parameter.isOptional or parameter.defaultValue !== undefined %}Optional. Default is `{$ parameter.defaultValue === undefined and 'undefined' or parameter.defaultValue $}`.{% endif %}
      {% endmarked %}
      </td>
    </tr>{% endfor %}
  </tbody>
</table><commit_msg>build(docs-infra): render short description of parameters in API docs (#24537)<commit_after>{% macro paramList(params, truncateLines) -%}
  {%- if params -%}
    ({%- for param in params -%}
      {$ param | escape | truncateCode(truncateLines) $}{% if not loop.last %}, {% endif %}
    {%- endfor %})
  {%- endif %}
{%- endmacro -%}


{% macro returnType(returnType) -%}
  {%- if returnType %}: {$ returnType | escape $}{% endif -%}
{%- endmacro -%}

{%- macro renderParameters(parameters, containerClass, parameterClass, showType) -%}
{%- if parameters.length -%}
<table class="is-full-width list-table parameters-table {$ containerClass $}">
  <tbody>
  {% for parameter in parameters %}
    <tr class="{$ parameterClass $}">
      <td class="param-name"><a id="{$ parameter.anchor $}"></a>{$ parameter.name $}</td>
      {% if showType %}<td class="param-type"><code>{$ parameter.type $}</code></td>{% endif %}
      <td class="param-description">
      {% marked %}
      {% if (parameter.shortDescription | trim) or (parameter.description | trim) %}{$ parameter.shortDescription + '\n\n' + parameter.description $}
      {% elseif not showType and parameter.type %}<p>Type: <code>{$ parameter.type $}</code>.</p>
      {% endif %}

      {% if parameter.isOptional or parameter.defaultValue !== undefined %}Optional. Default is `{$ parameter.defaultValue === undefined and 'undefined' or parameter.defaultValue $}`.{% endif %}
      {% endmarked %}
      </td>
    </tr>{% endfor %}
  </tbody>
</table>
{'fraction_non_alphanumeric': 0.20396797772363384, 'fraction_numerical': 0.001740341106856944, 'mean_word_length': 3.533123028391167, 'pattern_counts': {'":': 0, '<': 43, '<?xml version=': 0, '>': 43, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2976062', 'n_tokens_mistral': 960, 'n_tokens_neox': 865, 'n_words': 213}