使用上面的任何方法，它在 `/docs` 中看起来都是这样的:

<img src="/img/tutorial/body-fields/image01.png">

## 技术细节

关于 `example` 和 `examples`...

JSON Schema在最新的一个版本中定义了一个字段 <a href="https://json-schema.org/draft/2019-09/json-schema-validation.html#rfc.section.9.5" class="external-link" target="_blank">`examples`</a> ，但是 OpenAPI 基于之前的一个旧版JSON Schema，并没有 `examples`.

Laura Kassovic <******@****.***> 1701107622 -0800

*/

// +k8s:deepcopy-gen=package
// +k8s:conversion-gen=k8s.io/apiserver/pkg/apis/example2
// +k8s:conversion-gen=k8s.io/apiserver/pkg/apis/example
// +k8s:openapi-gen=false
// +k8s:defaulter-gen=TypeMeta
// +k8s:protobuf-gen=package

// +groupName=example2.apiserver.k8s.io

//     <URL>.getEscapedPath() <string>
//     <URL>.getQuery() <map <string>, <list <string>>
//
// Examples:
//
//	url('/path').getScheme() // returns ''
//	url('https://example.com/').getScheme() // returns 'https'
//	url('https://example.com:80/').getHost() // returns 'example.com:80'
//	url('https://example.com/').getHost() // returns 'example.com'
//	url('https://[::1]:80/').getHost() // returns '[::1]:80'

# limitations under the License.
"""Tests for tensorflow.compiler.mlir.tfr.examples.pad.ops_defs."""

import os
from absl.testing import parameterized
import tensorflow as tf

from tensorflow.compiler.mlir.tfr.examples.pad import gen_pad_ops
from tensorflow.compiler.mlir.tfr.examples.pad import ops_defs
from tensorflow.compiler.mlir.tfr.python import test_utils

example.com/cmd contains main packages.

v1.0.0 is the latest non-retracted version. Other versions contain errors or
detectable problems.

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

go 1.16
-- go.mod --
module example.com/cmd

go 1.16
-- a/a.go --
package main

import "fmt"

func main() { fmt.Println("a@v1.0.0") }
-- b/b.go --
package main

import "fmt"

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

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

go 1.17
-- b.go --

Written by hand.
Test case for package moved into a parent module.

-- .mod --
module example.com/join/subpkg

require example.com/join v1.1.0
-- .info --

Written by hand.
Test case for package moved into a parent module.

-- .mod --
module example.com/join
-- .info --
{"Version": "v1.1.0"}
-- subpkg/x.go --

example.com/latemigrate/v2 v2.0.1
written by hand

This repository migrated to modules in v2.0.1 after v2.0.0 was already tagged.
All versions require rsc.io/quote so we can test downgrades.

v2.0.1 belongs to example.com/latemigrate/v2.

-- .mod --
module example.com/latemigrate/v2

require rsc.io/quote v1.3.0
-- .info --
{"Version":"v2.0.1"}
-- go.mod --
module example.com/latemigrate/v2

require rsc.io/quote v1.3.0