1 files changed, 46 insertions, 0 deletions
diff --git a/cmd/crane/doc/crane_tag.md b/cmd/crane/doc/crane_tag.md
new file mode 100644
index 0000000..5433467
--- /dev/null
+++ b/cmd/crane/doc/crane_tag.md
@@ -0,0 +1,46 @@
+## crane tag
+
+Efficiently tag a remote image
+
+### Synopsis
+
+This differs slightly from the "copy" command in a couple subtle ways:
+
+1. You don't have to specify the entire repository for the tag you're adding. For example, these two commands are functionally equivalent:
+```
+crane cp registry.example.com/library/ubuntu:v0 registry.example.com/library/ubuntu:v1
+crane tag registry.example.com/library/ubuntu:v0 v1
+```
+
+2. We can skip layer existence checks because we know the manifest already exists. This makes "tag" slightly faster than "copy".
+
+```
+crane tag IMG TAG [flags]
+```
+
+### Examples
+
+```
+# Add a v1 tag to ubuntu
+crane tag ubuntu v1
+```
+
+### Options
+
+```
+  -h, --help   help for tag
+```
+
+### Options inherited from parent commands
+
+```
+      --allow-nondistributable-artifacts   Allow pushing non-distributable (foreign) layers
+      --insecure                           Allow image references to be fetched without TLS
+      --platform platform                  Specifies the platform in the form os/arch[/variant][:osversion] (e.g. linux/amd64). (default all)
+  -v, --verbose                            Enable debug logs
+```
+
+### SEE ALSO
+
+* [crane](crane.md)	 - Crane is a tool for managing container images
+