* `url` (**обязательно**): `str`-значение с URL-адресом для внешней документации.

### Создание метаданных для тегов { #create-metadata-for-tags }

Давайте попробуем сделать это на примере с тегами для `users` и `items`.

Создайте метаданные для ваших тегов и передайте их в параметре `openapi_tags`:

{* ../../docs_src/metadata/tutorial004_py310.py hl[3:16,18] *}

    }


def test_encode_dataclass():
    item = Item(name="foo", count=100)
    assert jsonable_encoder(item) == {"name": "foo", "count": 100}
    assert jsonable_encoder(item, include={"name"}) == {"name": "foo"}
    assert jsonable_encoder(item, exclude={"count"}) == {"name": "foo"}
    assert jsonable_encoder(item, include={}) == {}
    assert jsonable_encoder(item, exclude={}) == {"name": "foo", "count": 100}

				<div class="mt-3">
					<p class="mb-1"><la:message key="labels.search_popular_word_word" /></p>
					<p>
						<c:forEach var="item" varStatus="s" items="${popularWords}">
							<la:link href="/search?q=${f:u(item)}${fe:facetQuery()}${fe:geoQuery()}"
								styleClass="btn btn-outline-secondary btn-sm me-1 mb-1">${f:h(item)}</la:link>
						</c:forEach>
					</p>
				</div>
			</c:if>
		</div>
	</div>

                    "message": {
                        "title": "Message",
                        "type": "string"
                    }
                }
            },
            "Item": {
                "title": "Item",
                "required": [
                    "id",
                    "value"
                ],
                "type": "object",
                "properties": {

                        "properties": {
                            "errors": {
                                "title": "Errors",
                                "type": "array",
                                "items": {"$ref": "#/components/schemas/Error"},
                            }
                        },
                    },
                }
            },
        }

    }

    /**
     * Retrieves a specific Kuromoji dictionary item by ID.
     *
     * @param dictId the dictionary ID
     * @param id the ID of the Kuromoji item to retrieve
     * @return JSON response containing the Kuromoji dictionary item
     */
    // GET /api/admin/dict/kuromoji/setting/{dictId}/{id}
    @Execute

                        "properties": {
                            "errors": {
                                "title": "Errors",
                                "type": "array",
                                "items": {"$ref": "#/components/schemas/Error"},
                            }
                        },
                    },
                }
            },
        }

					/></label>
				<div class="col-lg-5 col-md-8 col-sm-7 col-6">
					<la:select property="lang" styleId="langSearchOption" multiple="true" styleClass="form-control">
						<c:forEach var="item" items="${langItems}">
							<la:option value="${f:u(item.value)}">${f:h(item.label)}</la:option>
						</c:forEach>
					</la:select>
				</div>
			</div>
			<c:if test="${displayLabelTypeItems}">
				<div class="mb-3 row">

                    "message": {
                        "title": "Message",
                        "type": "string"
                    }
                }
            },
            "Item": {
                "title": "Item",
                "required": [
                    "id",
                    "value"
                ],
                "type": "object",
                "properties": {

import org.apache.maven.api.annotations.Experimental;

/**
 * Enumeration defining different retention periods for cached data.
 * Each value represents a specific scope and lifetime for cached items.
 *
 * @since 4.0.0
 */
@Experimental
public enum CacheRetention {
    /**
     * Data should be persisted across Maven invocations.
     * Suitable for:
     * - Dependency resolution results