-- .info --
{"Version":"v1.9.0"}
-- .mod --
// Deprecated: in example.com/deprecated/a@v1.9.0
module example.com/deprecated/a

go 1.17
-- go.mod --
// Deprecated: in example.com/deprecated/a@v1.9.0
module example.com/deprecated/a

go 1.17
-- a.go --
package a

-- cmd/a/a.go --
package main

import "fmt"

example.com/generics v1.0.0
written by hand

-- .mod --
module example.com/generics

go 1.18
-- .info --
{"Version":"v1.0.0"}
-- go.mod --
module example.com/generics

go 1.18
-- generics.go --
package generics

type Int interface {
	~int
}

example.com/depends/on/generics v1.0.0
written by hand

-- .mod --
module example.com/depends/on/generics

go 1.18

require example.com/generics v1.0.0
-- .info --
{"Version":"v1.0.0"}
-- go.mod --
module example.com/depends/on/generics

go 1.18

require example.com/generics v1.0.0
-- main.go --
package main

import "example.com/generics"

所以，虽然 `example` 不是JSON Schema的一部分，但它是OpenAPI的一部分，这将被文档UI使用。

## 其他信息

Portanto, embora `example` não seja parte do JSON Schema, é parte da versão customizada do JSON Schema usada pelo OpenAPI, e é isso que vai ser usado dentro da UI de documentação.

-- .info --
{"Version":"v1.0.0"}
-- .mod --
// Deprecated: in v1.0.0
module example.com/undeprecated

go 1.17
-- go.mod --
// Deprecated: in v1.0.0
module example.com/undeprecated

go 1.17
-- undeprecated.go --
package undeprecated

-- cmd/a/a.go --
package main

import "fmt"

そのため、OpenAPIでは同じ目的のために<a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#fixed-fields-20" class="external-link" target="_blank">`example`</a>を独自に定義しており（`examples`ではなく`example`として）、それがdocs UI（Swagger UIを使用）で使用されています。

つまり、`example`はJSON Schemaの一部ではありませんが、OpenAPIの一部であり、それがdocs UIで使用されることになります。

Vor OpenAPI 3.1.0 verwendete OpenAPI eine ältere und modifizierte Version von **JSON Schema**.

JSON Schema hatte keine `examples`, daher fügte OpenAPI seiner eigenen modifizierten Version ein eigenes `example`-Feld hinzu.

OpenAPI fügte auch die Felder `example` und `examples` zu anderen Teilen der Spezifikation hinzu:

### OpenAPI-특화 `examples`

**JSON 스키마**가 `examples`를 지원하기 전 부터, OpenAPI는 `examples`이라 불리는 다른 필드를 지원해 왔습니다.

이 **OpenAPI-특화** `examples`는 OpenAPI 명세서의 다른 구역으로 들어갑니다. 각 JSON 스키마 내부가 아니라 **각 *경로 작동* 세부 정보**에 포함됩니다.

그리고 Swagger UI는 이 특정한 `examples` 필드를 한동안 지원했습니다. 그래서, 이를 다른 **문서 UI에 있는 예제**를 **표시**하기 위해 사용할 수 있습니다.

-- .info --
{"Version":"v1.0.0"}
-- .mod --
module example.com/deprecated/a

go 1.17
-- go.mod --
module example.com/deprecated/a

go 1.17
-- a.go --
package a

-- cmd/a/a.go --
package main

import "fmt"