### Ellipsis

- Keep ellipsis style (`...`) consistent with existing Turkish docs.
- Never modify `...` in code, URLs, or CLI examples.

### Consistency

- Use the same translation for the same term throughout the document.
- If you translate a concept one way, keep it consistent across all occurrences.

### Links and references

- Never modify link syntax like `{.internal-link target=_blank}`.

import gradlebuild.docs.dsl.source.model.PropertyMetaData;
import gradlebuild.docs.dsl.source.model.TypeMetaData;
import org.gradle.internal.UncheckedException;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

Este código no se ejecutará en tu aplicación, solo lo necesitamos para *documentar* cómo debería verse esa *API externa*.

Pero ya sabes cómo crear fácilmente documentación automática para una API con **FastAPI**.

    assert "Error processing docs/lang/docs/doc.md" in result.output
    assert (
        "Number of code include placeholders does not match the number of code includes "
        "in the original document (4 vs 3)"
    ) in result.output


@pytest.mark.parametrize(
    "copy_test_files",
    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
    indirect=True,
)

    @Test
    public void test_concatKinds_secondEmpty() {
        SuggestItem.Kind[] kinds1 = { SuggestItem.Kind.DOCUMENT };

        SuggestItem.Kind[] result = SuggestItem.concatKinds(kinds1, new SuggestItem.Kind[0]);

        assertEquals(1, result.length);
        assertEquals(SuggestItem.Kind.DOCUMENT, result[0]);
    }

    @Test
    public void test_concatKinds_noDuplicatesFromSecondArray() {

        assertNotNull(response);
    }

    @Test
    public void test_addKind() throws Exception {
        indexItems();

        SuggestResponse response = suggester.suggest().addKind("document").execute().getResponse();

        assertNotNull(response);
    }

    @Test
    public void test_addLang() throws Exception {
        SuggestItem[] items = new SuggestItem[1];

margin).removeData('margin-right')\n      }\n    })\n\n    // Restore body padding\n    const padding = $(document.body).data('padding-right')\n    $(document.body).removeData('padding-right')\n    document.body.style.paddingRight = padding ? padding : ''\n  }\n\n  _getScrollbarWidth() { // thx d.walsh\n    const scrollDiv = document.createElement('div')\n    scrollDiv.className = CLASS_NAME_SCROLLBAR_MEASURER\n    document.body.appendChild(scrollDiv)\n    const scrollbarWidth = scrollDiv.getBoundingClientRect().width...

import jakarta.validation.constraints.Size;

/**
 * Form class for thumbnail request parameters.
 * Contains the document ID and query parameters needed to retrieve thumbnail images.
 */
public class ThumbnailForm {

    /**
     * The document ID for which to retrieve the thumbnail.
     */
    @Required
    @Size(max = 100)
    public String docId;

    /**

        assertEquals(exp, transformer.getFileName(url, Constants.UTF_8));

        url = "s3://my-bucket/folder/document.pdf";
        exp = "document.pdf";
        assertEquals(exp, transformer.getFileName(url, Constants.UTF_8));

        url = "gcs://my-bucket/folder/document.pdf";
        exp = "document.pdf";
        assertEquals(exp, transformer.getFileName(url, Constants.UTF_8));
    }

    @Test

        byte[] data = new byte[] { 1, 2, 3 };
        t.setMechanismToken(data);
        assertArrayEquals(data, t.getMechanismToken(), "mechanismToken should round-trip");

        // Document current behavior: no defensive copy (reference exposed)
        data[0] = 9;
        assertEquals(9, t.getMechanismToken()[0], "no defensive copy; reflects external mutation");
    }

    @Test