fix: improve consistency of backticks in usage messages#863
fix: improve consistency of backticks in usage messages#863dandavison merged 1 commit intotemporalio:mainfrom
Conversation
| s.Command.Short = "Show Workflow Executions" | ||
| if hasHighlighting { | ||
| s.Command.Long = "List Workflow Executions. The optional \x1b[1m--query\x1b[0m limits the output to\nWorkflows matching a Query:\n\n\x1b[1mtemporal workflow list \\\n --query YourQuery\x1b[1m\x1b[0m\n\nVisit https://docs.temporal.io/visibility to read more about Search Attributes\nand Query creation. See \x1b[0mtemporal batch --help` for a quick reference.\n\nView a list of archived Workflow Executions:\n\n\x1b[1mtemporal workflow list \\\n --archived\x1b[0m" | ||
| s.Command.Long = "List Workflow Executions. The optional \x1b[1m--query\x1b[0m limits the output to\nWorkflows matching a Query:\n\n\x1b[1mtemporal workflow list \\\n --query YourQuery\x1b[0m\n\nVisit https://docs.temporal.io/visibility to read more about Search Attributes\nand Query creation. See \x1b[1mtemporal batch --help\x1b[0m for a quick reference.\n\nView a list of archived Workflow Executions:\n\n\x1b[1mtemporal workflow list \\\n --archived\x1b[0m" |
There was a problem hiding this comment.
Anyone know why the ANSI escapes changed here? Haven't tested in a terminal but the new version LGTM. (1m is a transition to bold and 0m is a transition that removes all flags.)
There was a problem hiding this comment.
I believe this is related to this change; previously there was an extraneous hanging backtick on the code block for temporal workflow list --query YourQuery, so the parser that creates the highlighted version of the help text may have gotten a bit confused. Here's how it looks today:
With this patch:
This is actually the exact typo that I noticed that sent me down this rabbit hole 😄
There was a problem hiding this comment.
Excellent, thanks for looking into this.
dandavison
left a comment
There was a problem hiding this comment.
Thanks @stpierre! LGTM
* Remove extraneous trailing backticks * Add missing backticks where obviously needed * Improve consistency of quoting This doesn't fix every inconsistent use of backticks, but it does remove a few dangling backticks, and in places where quoting was inconsistent (i.e., a mix of backticks, quotes, and/or no quotes in a single usage message) makes it slightly more consistent.
3f52554 to
8aca3ec
Compare
What was changed
This doesn't fix every inconsistent use of backticks, but it does remove a few dangling backticks, and in places where quoting was inconsistent (i.e., a mix of backticks, quotes, and/or no quotes in a single usage message) makes it slightly more consistent.
Why?
Prettier usage :)
Checklist
Closes
How was this tested: