docs: promotion instructions to "working with stages"

docs/docs/60-new-docs/50-user-guide/20-how-to-guides/14-working-with-stages.md

@@ -484,11 +484,40 @@ Users with credentials for and sufficient permissions within the Kargo control p
 
 ### Promoting Freight to a Stage
 
-:::note
-**Maintainers Note**
+<Tabs groupId="promoting">
+<TabItem value="ui" label="Using the UI" default>
 
-Placeholder
-:::
+1. Click on the target icon to the left of the `Stage`:
+
+    ![Promote Freight to a Stage](img/promote-freight-to-a-stage.png)
+
+2. Select the desired `Freight` from the <Hlt>Freight Timeline</Hlt>, and click <Hlt>Yes</Hlt> to promote:
+
+    ![Promote Freight to a Stage](img/promote-freight-to-a-stage-2.png)
+
+</TabItem>
+<TabItem value="cli" label="Using the CLI">
+
+To promote `Freight` to a `Stage` using the CLI, run:
+
+```shell
+kargo promote \
+  --project kargo-demo \
+  --freight f5f87aa23c9e97f43eb83dd63768ee41f5ba3766 \
+  --stage prod
+```
+
+Alternatively, you can reference the `Freight` you wish to promote using its alias:
+
+```shell
+kargo promote \
+  --project kargo-demo \
+  --freight-alias frozen-tauntaun \
+  --stage prod
+```
+
+</TabItem>
+</Tabs>
 
 ### Deleting a Stage