Normalize capitalization and punctuation in command descriptions and summaries

[adam-wolfe]

What It Does
Attempts to provide greater consistency in terms of punctuation and capitalization for Zowe CLI command help text.

General rules applied:

• Capitalize the first letter of all descriptions, summaries, and options.
• End every description with a period.
• End every summary without a period (this requires shortening multi-sentence summaries to a single sentence).

Automating enforcement of these rules may be too complicated unless there is a way to programmatically get all help strings. Scanning the code line-by-line can be easily confounded by use of variables instead of literals.

I left option descriptions and examples mostly as they were.

How to Test
Try some zowe commands and look at the help text. Everything should start with a capital letter. Descriptions end with a period. Summaries end without a period unless they are multiple sentences.

Review Checklist
I certify that I have:

• tested my changes
• added/updated automated tests
• updated the changelog
• followed the contribution guidelines

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (a5a6750) 91.03% compared to head (6f30932) 91.03%.
Report is 2 commits behind head on next.

Additional details and impacted files

@@           Coverage Diff           @@
##             next    #1991   +/-   ##
=======================================
  Coverage   91.03%   91.03%           
=======================================
  Files         635      635           
  Lines       18608    18610    +2     
  Branches     3859     3859           
=======================================
+ Hits        16939    16941    +2     
  Misses       1668     1668           
  Partials        1        1           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ATorrise]

👍

[sonarqubecloud]

Quality Gate passed

Kudos, no new issues were introduced!

0 New issues
0 Security Hotspots
100.0% Coverage on New Code
0.9% Duplication on New Code

See analysis details on SonarCloud

[github-actions]

Release succeeded for the next branch. 🎉

The following packages have been published:

• npm: @zowe/secrets-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/imperative@8.0.0-next.202401031939
• npm: @zowe/cli-test-utils@8.0.0-next.202401031939
• npm: @zowe/core-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-uss-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/provisioning-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-console-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-files-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-logs-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zosmf-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-workflows-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-jobs-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/zos-tso-for-zowe-sdk@8.0.0-next.202401031939
• npm: @zowe/cli@8.0.0-next.202401031939

_{Powered by Octorelease 🚀}