Skip to content

Commit f8f4b02

Browse files
committed
Polish
1 parent f72e5f0 commit f8f4b02

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ dotnet tool install --global nuget-clear --version 1.0.0-preview1
1414

1515
## Examples
1616

17-
Let's find some versions of your package to delete:
17+
Let's find some versions of your package to delete on nuget.org:
1818

1919
```
2020
nuclear list My.Package
@@ -32,12 +32,18 @@ Let's nuke some packages! 🤯
3232
nuclear delete My.Package 2.0.0-* --api-key NUGET_API_KEY
3333
```
3434

35-
This [unlists](https://docs.microsoft.com/en-us/nuget/nuget-org/policies/deleting-packages) pre-releases of v2.0.0 of `My.Package` on nuget.org.
35+
This [unlists](https://docs.microsoft.com/nuget/nuget-org/policies/deleting-packages) pre-releases of `My.Package` v2.0.0 on nuget.org.
3636

37-
You can create API keys on nuget.org using [this documentation](https://docs.microsoft.com/en-us/nuget/nuget-org/publish-a-package#create-api-keys). Make sure to select the `Unlist package` scope when creating your API key.
37+
You can create API keys on nuget.org using [this documentation](https://docs.microsoft.com/nuget/nuget-org/publish-a-package#create-api-keys). Make sure to select the `Unlist package` scope when creating your API key.
3838

3939
## Reference
4040

41+
### Deleting vs unlisting?
42+
43+
NuGet servers are free to interpret "delete" operations. For example, [nuget.org unlists packages](https://docs.microsoft.com/nuget/nuget-org/policies/deleting-packages) to prevent the ["left-pad problem"](https://blog.npmjs.org/post/141577284765/kik-left-pad-and-npm). Unlisted packages are undiscoverable on nuget.org and may be re-listed in the future.
44+
45+
However, private NuGet servers like [BaGet can be configured to delete packages](https://loic-sharma.github.io/BaGet/configuration/#enable-package-hard-deletions). You may not be able to undo a package deletion, so be careful!
46+
4147
### Version ranges
4248

4349
NuGet packages use [semantic versioning](https://semver.org/) and has the form `Major.Minor.Patch[-PreleaseLabel]`. Examples include `1.0.0` or `1.0.0-preview1`. A package is considered *pre-release* if it has a pre-release label, or *stable* otherwise.

0 commit comments

Comments
 (0)