/favorites:
    get:
      tags:
        - favorite
      summary: List favorites
      description: Returns favorited document IDs
      operationId: listFavorites
      parameters:
        - name: queryId
          in: query
          description: Query ID where the document is contained
          required: true
          schema:
            type: string
            example: queryid
      responses:

    //                                                                      ==============
    /**
     * Serves a thumbnail image for the specified document.
     *
     * @param form the thumbnail request form containing document ID and query parameters
     * @return ActionResponse containing the thumbnail image or 404 if not found
     */
    @Execute
    public ActionResponse index(final ThumbnailForm form) {

    /**
     * Default constructor for PurgeDocJob.
     * Creates a new instance of the document purging job with default settings.
     */
    public PurgeDocJob() {
        // Default constructor
    }

    /**
     * Executes the document purging job.
     * Removes all documents from the search index that have expired based on their expires field.
     *

        }
    }

    /**
     * Checks if a document exists in the OpenSearch index for the given session ID and URL.
     *
     * @param sessionId The session ID of the document.
     * @param url The URL of the document.
     * @return true if the document exists, false otherwise.
     * @throws OpenSearchAccessException if the existence check fails.
     */

    }

    /**
     * Deletes document words (words with DOC_FREQ >= 1 that don't have QUERY or USER kinds).
     *
     * @param index The index name
     * @return The SuggestDeleteResponse
     */
    public SuggestDeleteResponse deleteDocumentWords(final String index) {
        if (logger.isInfoEnabled()) {
            logger.info("Deleting document words: index={}", index);
        }

        if (logger.isDebugEnabled()) {
            logger.debug("Deleting document: url={}", dataMap.get(fessConfig.getIndexFieldUrl()));
        }

        // required check
        if (!dataMap.containsKey(fessConfig.getIndexFieldUrl()) || dataMap.get(fessConfig.getIndexFieldUrl()) == null) {
            logger.warn("Could not delete document: url field is missing or null");
            return false;
        }

     *
     * @return the index file name
     */
    String getIndexFileName();

    /**
     * Formats a document source map into the target format string.
     *
     * @param source the document source map
     * @param excludeFields the set of field names to exclude from output
     * @return the formatted string
     */

        return xml.toString();
    }

    public Document buildDocument() {
        try {
            String xmlContent = build();
            Editor editor = new Editor(Document.of(xmlContent));
            return editor.document();
        } catch (Exception e) {
            throw new RuntimeException("Failed to build POM document", e);
        }
    }

    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,
)

    return res


def process_one_page(path: Path) -> bool:
    """
    Fix one translated document by comparing it to the English version.

    Returns True if processed successfully, False otherwise.
    """

    try:
        lang_code = path.parts[1]
        if lang_code == "en":
            print(f"Skipping English document: {path}")
            return True

        en_doc_path = Path("docs") / "en" / Path(*path.parts[2:])