this(capacity, fair);
    checkArgument(capacity >= c.size());

    for (E e : c) add(e);
  }

  @SuppressWarnings("unchecked") // please don't try this home, kids
  private static <E> E[] newEArray(int capacity) {
    return (E[]) new Object[capacity];
  }

  /**
   * Inserts the specified element at the tail of this queue if it is possible to do so immediately

    this(capacity, fair);
    checkArgument(capacity >= c.size());

    for (E e : c) add(e);
  }

  @SuppressWarnings("unchecked") // please don't try this home, kids
  private static <E> E[] newEArray(int capacity) {
    return (E[]) new Object[capacity];
  }

  /**
   * Inserts the specified element at the tail of this queue if it is possible to do so immediately

     *
     * <p>The merge follows these rules:
     * <ul>
     * <li>IDs must match, or an IllegalArgumentException is thrown</li>
     * <li>Text is taken from item1</li>
     * <li>Readings are merged, maintaining uniqueness</li>
     * <li>Fields, tags, languages, and roles are merged, maintaining uniqueness</li>
     * <li>Kinds are merged, maintaining uniqueness</li>
     * <li>Frequencies (queryFreq, docFreq) are summed</li>

Pero te mostraré cómo mejorar eso a continuación. 🤓

## Operation IDs personalizados y mejores nombres de métodos { #custom-operation-ids-and-better-method-names }

Puedes **modificar** la forma en que estos operation IDs son **generados** para hacerlos más simples y tener **nombres de métodos más simples** en los clientes.

But I'll show you how to improve that next. 🤓

## Custom Operation IDs and Better Method Names { #custom-operation-ids-and-better-method-names }

You can **modify** the way these operation IDs are **generated** to make them simpler and have **simpler method names** in the clients.

     */
    public void setLanguages(final String[] languages) {
        this.languages = languages;
    }

    /**
     * Sets the kinds of the suggest item.
     * @param kinds The kinds to set.
     */
    public void setKinds(final Kind[] kinds) {
        this.kinds = kinds;
    }

    /**
     * Sets the empty source map.
     * @param emptySource The empty source map to set.
     */

        // Different word order should produce different IDs (since text is "word1 word2" vs "word2 word1")
        assertFalse("Different word order should produce different IDs", item1.getId().equals(item2.getId()));
    }

        item.setLanguages(languages.toArray(new String[languages.size()]));

        final SuggestItem.Kind[] itemKinds = new SuggestItem.Kind[kinds.size()];
        for (int i = 0; i < kinds.size(); i++) {
            final String kind = kinds.get(i);
            if (kind.equals(SuggestItem.Kind.DOCUMENT.toString())) {
                itemKinds[i] = SuggestItem.Kind.DOCUMENT;

Поскольку **FastAPI** основан на спецификации **OpenAPI**, его API можно описать в стандартном формате, понятном множеству инструментов.

Это упрощает генерацию актуальной **документации**, клиентских библиотек (<abbr title="Software Development Kits - Наборы средств разработки">**SDKs**</abbr>) на разных языках, а также **тестирования** или **воркфлоу автоматизации**, которые остаются синхронизированными с вашим кодом.

-->

#### What type of PR is this?

<!--
Add one of the following kinds:
/kind bug
/kind dependency
/kind cleanup
/kind documentation
/kind feature

Optionally add one or more of the following kinds if applicable:
/kind api-change
/kind deprecation
/kind failing-test
/kind flake
/kind regression
-->