Standardize use of capitalization and punctuation in command descriptions

[adam-wolfe]

Is your feature or enhancement request related to a problem or limitation? Please describe

Punctuation at the end of command description varies between commands. For example, enter zowe zos-files. The description for zowe zos-files compare does not end with a period, but the description for zowe zos-files copy does.

There is also inconsistency with respect to capitalization of the first word in command descriptions. For example, enter zowe config. The description for zowe config auto-init begins with a capital letter while the description for zowe config edit does not.

Describe your enhancement idea

Command descriptions should adhere to punctuation and capitalization rules across all available commands.

As far as I know, there is no industry standard for how command/option descriptions should be formatted. Some examples (in terms of command line options descriptions): Node.js is inconsistent, Python and Java seem to favor lowercase first character and no ending punctuation, Dotnet and VS Code (when called from the command line) use upper case first character and do end with a period.

In my opinion, it would be reasonable for all command descriptions to start with a capital letter (unless there is a specific reason against it) and end with a period (unless the description is a single word, or lacks a predicate).

Describe alternatives you've considered

Provide any additional context

zowe files:

zowe config:

[github-actions]

Thank you for raising this enhancement request.
The community has 90 days to vote on it.
If the enhancement receives at least 5 upvotes, it is added to our development backlog.
If it receives fewer votes, the issue is closed.

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

[github-actions]

This issue has been automatically closed due to lack of activity. In an effort to reduce noise, please do not comment any further.

[adam-wolfe]

Still planning to do this.

[adam-wolfe]

Implemented in #1991