Should Role Name be in Quotes in Set-Role Help Documentation?

[CBPSC]

[dnndev]

No. It can be, but it's not required. If the role name was something like Content Editor then it would need to be, because it contains a space.

[CBPSC]

Gotcha... makes sense. Thanks!

[david-poindexter]

In my opinion, this should be clarified in the --name Description. Something along the lines of "Use quotes when the role name contains spaces".

[dnndev]

This would need to be added to every option on every command that can have a string value. It is described in the Syntax topic help syntax.

[dnndev]

I'm open to options

[david-poindexter]

Good point. Seems like some tedious work, but most likely worthwhile for newbies. If you want, we can just create an issue for each command to handle these changes. I would prefer this over one single issue for all of them. I can work on this in spurts better than taking a long time to do all of them. Thoughts?

[dnndev]

I worry about help bloat. At a certain point, people have to understand the rules by which the program operates. Some possibilities may be that we make the docs more consistent (if they're not already)... that strings are never quoted unless they need to be. Or maybe we add a link to each topic that links to the syntax section describing string usage. Or... ?

[david-poindexter]

@dnndev totally agreed. I like the idea of a link being added to each topic.