diff --git a/man/man8/zfs-promote.8 b/man/man8/zfs-promote.8
index ba8cd5f6da..3cb8968873 100644
--- a/man/man8/zfs-promote.8
+++ b/man/man8/zfs-promote.8
@@ -29,7 +29,7 @@
 .\" Copyright 2018 Nexenta Systems, Inc.
 .\" Copyright 2019 Joyent, Inc.
 .\"
-.Dd June 30, 2019
+.Dd March 16, 2022
 .Dt ZFS-PROMOTE 8
 .Os
 .
@@ -59,6 +59,26 @@ The
 .Nm zfs Cm rename
 subcommand can be used to rename any conflicting snapshots.
 .
+.Sh EXAMPLES
+.\" These are, respectively, examples 10 from zfs.8
+.\" Make sure to update them bidirectionally
+.Ss Example 1 : No Promoting a ZFS Clone
+The following commands illustrate how to test out changes to a file system, and
+then replace the original file system with the changed one, using clones, clone
+promotion, and renaming:
+.Bd -literal -compact -offset Ds
+.No # Nm zfs Cm create Ar pool/project/production
+  populate /pool/project/production with data
+.No # Nm zfs Cm snapshot Ar pool/project/production Ns @ Ns Ar today
+.No # Nm zfs Cm clone Ar pool/project/production@today pool/project/beta
+  make changes to /pool/project/beta and test them
+.No # Nm zfs Cm promote Ar pool/project/beta
+.No # Nm zfs Cm rename Ar pool/project/production pool/project/legacy
+.No # Nm zfs Cm rename Ar pool/project/beta pool/project/production
+  once the legacy version is no longer needed, it can be destroyed
+.No # Nm zfs Cm destroy Ar pool/project/legacy
+.Ed
+.
 .Sh SEE ALSO
 .Xr zfs-clone 8 ,
 .Xr zfs-rename 8
diff --git a/man/man8/zfs.8 b/man/man8/zfs.8
index 9850215d97..aa8cd0e580 100644
--- a/man/man8/zfs.8
+++ b/man/man8/zfs.8
@@ -305,6 +305,7 @@ if invalid command line options were specified.
 .\" Examples 5 are shared with zfs-list.8.
 .\" Examples 8 are shared with zfs-rollback.8.
 .\" Examples 9, 10 are shared with zfs-clone.8.
+.\" Examples 10 are also shared with zfs-promote.8.
 .\" Examples 12, 13 are shared with zfs-send.8.
 .\" Examples 12, 13 are also shared with zfs-receive.8.
 .\" Examples 17, 18, 19, 20, 21 are shared with zfs-allow.8.