[docs] Make string entries more intuitive

[ischoegl]

Changes proposed in this pull request

Make string entries / linked documentation in YAML documentation more intuitive

If applicable, fill in the issue number this pull request is fixing

Closes #1576

Checklist

• [x] The pull request includes a clear description of this code change
• [x] Commit messages have short titles and reference relevant issues
• [x] Build passes (scons build & scons test) and unit tests address code coverage
• [x] Style & formatting of contributed code follows contributing guidelines
• [x] The pull request is ready for review

[codecov[bot]]

Codecov Report

Merging #1582 (bf51152) into main (4b30fa7) will decrease coverage by 0.01%. The diff coverage is n/a.

@@            Coverage Diff             @@
##             main    #1582      +/-   ##
==========================================
- Coverage   70.51%   70.51%   -0.01%     
==========================================
  Files         379      379              
  Lines       59118    59117       -1     
  Branches    21237    21237              
==========================================
- Hits        41686    41685       -1     
  Misses      14359    14359              
  Partials     3073     3073              

see 1 file with indirect coverage changes

:mega: We’re building smart automated test selection to slash your CI/CD build times. Learn more