From d8b2efd255cf8dd98549590a3cc327c9e7d184c8 Mon Sep 17 00:00:00 2001
From: Casper da Costa-Luis <casper.dcl@physics.org>
Date: Tue, 18 Oct 2022 23:12:37 +0100
Subject: [PATCH] ref/comment: update --publish options (#344)

* ref/comment: update --publish options

- follow-up to https://github.com/iterative/cml/pull/1208
- follow-up to https://github.com/iterative/cml/pull/1210

* more explicit, harder to miss
---
 content/docs/ref/comment.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/content/docs/ref/comment.md b/content/docs/ref/comment.md
index 416e486b..72938e14 100644
--- a/content/docs/ref/comment.md
+++ b/content/docs/ref/comment.md
@@ -42,12 +42,13 @@ Any [generic option](/doc/ref) in addition to:
 - `--watch`: Watch for changes and automatically update the comment (doesn't
   exit, consider
   [appending `&` to run in the background](<https://en.wikipedia.org/wiki/Job_control_(Unix)#Implementation>)).
-- `--publish`: Upload any local images found in the Markdown report.
+- `--publish=<true|false>`: Upload any local images found in the Markdown
+  report.
+- `--publish-native`: Uses `--driver`'s native capabilities to `--publish`
+  assets instead of `--publish-url` (not available on `--driver=github`).
 - `--publish-url=<url>`: Self-hosted image server URL [default:
   `https://asset.cml.dev`], see
   [minroud-s3](https://github.com/iterative/minroud-s3).
-- `--native`: Uses `--driver`'s native capabilities to `--publish` assets
-  instead of `--publish-url` (not available on `--driver=github`).
 
 ## FAQs and Known Issues