docs: Improve ORAS diagnose experience

[FeynmanZhou]

What this PR does / why we need it:

This proposal document aims to:

1. Identify the issues associated with the current implementation of the --verbose and --debug options.
2. Clarify the concepts of verbose output and debug logs.
3. List the guiding principles to write comprehensive, clear, and conducive verbose output and debug logs for effective diagnosis.
4. Propose solutions to improve the diagnostic experience for ORAS CLI users and developers.
5. Add examples for proposed changes (more examples will be appended).

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Fixes #1091

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 83.99%. Comparing base (ebee694) to head (719464b).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1483      +/-   ##
==========================================
+ Coverage   83.96%   83.99%   +0.03%     
==========================================
  Files         119      119              
  Lines        5306     5306              
==========================================
+ Hits         4455     4457       +2     
+ Misses        604      602       -2     
  Partials      247      247              

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

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests

[toddysm]

IMHO, if a user decides to get verbose output, he or she will be prepared to receive a lot of information in the output (including very technical information - for example, curl gives details about the encryption algorithm). I am still not convinced that we need to complicate the interface to suppress some of the output.

[TerryHowe]

Latest changes lgtm

[Wwwsylvia]

LGTM

[shizhMSFT]

LGTM

[shizhMSFT]

LGTM