Skip to content

Commit 76a677c

Browse files
committed
Publishing docs: strengthen language around not re-using tags, add example.
1 parent d3e57f1 commit 76a677c

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

pages/docs/publish.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -51,9 +51,16 @@ version listed in the manifest file. So, if the version field in the manifest
5151
is "0.1.1" the tag should be either "0.1.1" or "v0.1.1". If the manifest file
5252
is valid, the version will be automatically added to the plugins site.
5353

54-
We highly suggest that you **do not overwrite old tags**, instead, update the
55-
version number tag in the manifest, commit, and create a new tag to fix any
56-
errors you've encountered.
54+
The registry **does not support re-processing tags that it has already seen.**
55+
Therefore, we strongly suggest that you **do not overwrite old tags**. Instead,
56+
update the version number tag in the manifest, commit, and create a new tag to
57+
fix any errors you've encountered.
58+
59+
For example, you've pushed version `v1.7.0` of your plugin, but there is an
60+
[error detected](/error.log) in the manifest. If you fix the error, delete,
61+
re-create, and push another `v1.7.0` tag, the registry **will not** detect it.
62+
You will have to create and push `v1.7.1`.
63+
5764

5865
## Troubleshooting
5966

0 commit comments

Comments
 (0)