documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Terminus Manual Doc Update

Open justkristin opened this issue 4 years ago • 3 comments

Re: Terminus Manual

Priority: Low

Issue Description:

Having problems creating a site, but only getting the following error message: [error] The operation failed to complete. Added --verbose and had no change to the error message. Noted that, in the "verbose" section of Options, there are instructions which seem to hint at giving the verbose option a value: Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug When I tried giving it the value of 3, however, I was told: The "--verbose" option does not accept a value.

As a currently nervous new-hire, I will own this one, as I was able to figure it out by simply entering the blank command terminus site:create at which point I saw that what I really wanted was -v, -vv or -vvv

It may be good, for new kids, however, to add the short versions of options to the instructions...? Sorry!

Suggested Resolution

justkristin avatar Sep 13 '21 20:09 justkristin

Thank you for opening this issue @justkristin 🥳

joan-ing avatar Sep 13 '21 21:09 joan-ing

relates to #6665

EdwardAngert avatar Sep 14 '21 20:09 EdwardAngert

@kporras07 I was poking around in the Terminus repo, but didn't see where I might be able to suggest this change

In commands.json, each command that can accept a -v/vv/vvv has

"description": "Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug",

would we be able to modify that to read:

"description": "Increase the verbosity of messages: 1 for normal output (-v), 2 for more verbose output (-vv), and 3 for debug (-vvv)",

EdwardAngert avatar Feb 03 '22 21:02 EdwardAngert

Related PR in terminus repo: https://github.com/pantheon-systems/terminus/pull/2320

kporras07 avatar Aug 24 '22 15:08 kporras07

This issue can be closed here in docs - we will update the terminus output description and include this in the next version (v3.0.9)

scottbuscemi avatar Aug 24 '22 15:08 scottbuscemi