Jay Conrod <******@****.***> 1585924975 -0400

Module example.com/retract/description retracts all versions of itself.
The rationale comments have various problems.

-- .mod --
module example.com/retract/rationale

go 1.14

retract (
	v1.0.0-empty

	// short description
	// more
	//
	// detail
	v1.0.0-multiline1 // suffix
	// after not included
)

// short description
// more
//
// detail
retract v1.0.0-multiline2 // suffix

Итак, хотя поле `example` не является частью JSON-схемы, оно является частью настраиваемой версии JSON-схемы в OpenAPI, и именно это поле будет использоваться в UI документации.

example.com/pseudoupgrade v0.1.0
written by hand

-- .mod --
module example.com/pseudoupgrade

-- .info --
{"Version":"v0.1.0","Name":"","Short":"","Time":"2019-04-29T07:30:30Z"}

-- pseudoupgrade.go --
package pseudoupgrade

-- .mod --
module example.com/retract/ambiguous

go 1.16
-- .info --
{"Version":"v1.0.0"}
-- nested/nested.go --

This version should be retracted, but the go.mod file for the version that would
contain the retraction is not available.
-- .mod --
module example.com/retract/missingmod

go 1.14
-- .info --
{"Version":"v1.0.0"}
-- missingmod.go --

Jay Conrod <******@****.***> 1586976135 -0400

Module example.com/retract/self/prev is a module that retracts its own
latest version, as well as an earlier version.

A previous unretracted release version, v1.1.0, is still available.

-- .mod --
module example.com/retract/self/prev

go 1.15

retract v1.0.0-bad // bad
retract v1.9.0 // self

-- .info --
{"Version":"v1.9.0"}

-- p.go --

See example.com_retract_self_pseudo_v1.9.0.txt.

This version is not retracted. It should be returned by the proxy's
@latest endpoint. It should match the @latest version query.

TODO(golang.org/issue/24031): the proxy and proxy.golang.org both return
the highest release version from the @latest endpoint, even if that
version is retracted, so there is no way for the go command to
discover an unretracted pseudo-version.

-- .mod --

example.com/badchain/b v1.1.0

-- .mod --
module example.com/badchain/b

require example.com/badchain/c v1.1.0
-- .info --
{"Version":"v1.1.0"}
-- b.go --
package b