Added cli doc generation and refactored examples

[zr-msft]

trafficstars

…Examples field

Here is a launch.json for testing:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Generate Docs",
            "type": "go",
            "request": "launch",
            "mode": "auto",
            "program": "${fileDirname}",
            "env": 
                {
                    "GEN_CLI_DOCS": "true"
                },
        }
    ]
}

MD files are generated in notation-reference-doc but have been added to .gitignore to avoid adding them to the repo

If environment variable is absent, behavior should be normal.

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 77.24138% with 33 lines in your changes missing coverage. Please review.

Project coverage is 63.20%. Comparing base (b7e5a6f) to head (b4bd926). Report is 139 commits behind head on main.

Files with missing lines	Patch %	Lines
cmd/notation/generate_docs.go	25.00%	32 Missing and 1 partial :warning:

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #687      +/-   ##
==========================================
- Coverage   63.98%   63.20%   -0.78%     
==========================================
  Files          40       41       +1     
  Lines        2252     2294      +42     
==========================================
+ Hits         1441     1450       +9     
- Misses        689      721      +32     
- Partials      122      123       +1     

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[zr-msft]

@yizha1 moving to draft to avoid merging and adding risk to the next release

[github-actions[bot]]

This PR is stale because it has been opened for 45 days with no activity. Remove stale label or comment. Otherwise, it will be closed in 30 days.

[rayoef]

@yizha1 Besides the private preview comments, is this PR OK to merge?

[yizha1]

Hi @rayoef It seems this PR is no longer up-to-date. @FeynmanZhou Could you please advise on the next steps for this PR, since it is related to the CLI doc generation?

[github-actions[bot]]

This PR is stale because it has been opened for 45 days with no activity. Remove stale label or comment. Otherwise, it will be closed in 30 days.

[github-actions[bot]]

This PR is stale because it has been opened for 45 days with no activity. Remove stale label or comment. Otherwise, it will be closed in 30 days.

[github-actions[bot]]

This PR is stale because it has been opened for 45 days with no activity. Remove stale label or comment. Otherwise, it will be closed in 30 days.

[yizha1]

Close this PR. @zr-msft is being honored in memoriam.