2023-11-22 10:20:35 -07:00
|
|
|
name: Pkg.go.dev package removal request
|
|
|
|
description: Request a package be removed from the documentation site (pkg.go.dev)
|
|
|
|
title: "x/pkgsite: package removal request for [type path here]"
|
|
|
|
labels: ["pkgsite/package-removal"]
|
|
|
|
body:
|
|
|
|
- type: markdown
|
|
|
|
attributes:
|
|
|
|
value: "Please answer these questions before submitting your issue. Thanks!"
|
|
|
|
- type: input
|
|
|
|
id: package-path
|
|
|
|
attributes:
|
|
|
|
label: "What is the path of the package that you would like to have removed?"
|
2023-12-29 12:09:16 -07:00
|
|
|
description: |
|
|
|
|
We can remove packages with a shared path prefix.
|
|
|
|
For example, a request for 'github.com/author' would remove all pkg.go.dev pages with that package path prefix.
|
2023-11-22 10:20:35 -07:00
|
|
|
validations:
|
|
|
|
required: true
|
|
|
|
- type: textarea
|
|
|
|
id: package-owner
|
|
|
|
attributes:
|
|
|
|
label: "Are you the owner of this package?"
|
2023-12-29 12:09:16 -07:00
|
|
|
description: |
|
|
|
|
Only the package owners can request to have their packages removed from pkg.go.dev.
|
|
|
|
If the package path doesn't include your github username, please provide some other form of proof of ownership.
|
2023-11-22 10:20:35 -07:00
|
|
|
validations:
|
|
|
|
required: true
|
|
|
|
- type: textarea
|
|
|
|
id: retraction-reason
|
|
|
|
attributes:
|
|
|
|
label: "What is the reason that you could not retract this package instead?"
|
2023-12-29 12:09:16 -07:00
|
|
|
description: |
|
|
|
|
Requesting we remove a module here only hides the generated documentation on pkg.go.dev.
|
|
|
|
It does not affect the behaviour of proxy.golang.org or the go command.
|
|
|
|
Instead we recommend using the retract directive which will be processed by all 3 of the above.
|
|
|
|
|
|
|
|
If you have deleted your repo, please recreate it and publish a retraction.
|
|
|
|
|
|
|
|
Retracting a module version involves adding a retract directive to your go.mod file and publishing a new version.
|
|
|
|
For example: https://github.com/jba/retract-demo/blob/main/go.mod#L5-L8.
|
|
|
|
See https://pkg.go.dev/about#removing-a-package for additional tips on retractions.
|
2023-11-22 10:20:35 -07:00
|
|
|
validations:
|
|
|
|
required: true
|