📖 Adding missing documentation for Token-Permissions

[ristomcgehee]

• Please check if the PR fulfills these requirements

• [n/a] Tests for the changes have been added (for bug fixes / features)
• PR title follows the guidelines defined in https://github.com/ossf/scorecard/blob/main/CONTRIBUTING.md#pr-process

• What kind of change does this PR introduce? (Bug fix, feature, docs update, ...)
  Docs update

• What is the current behavior? (You can also link to an open issue here)
  The Token-Permissions check documentation does not include documentation on when the score is reduced due to certain write permissions being present on a job.

[codecov-commenter]

Codecov Report

Merging #1656 (83b8194) into main (4c82c29) will increase coverage by 3.18%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             main    #1656      +/-   ##
==========================================
+ Coverage   58.50%   61.69%   +3.18%     
==========================================
  Files          58       58              
  Lines        5801     5801              
==========================================
+ Hits         3394     3579     +185     
+ Misses       2170     1979     -191     
- Partials      237      243       +6     

[github-actions]

Integration tests success for
[3e4321c]
(https://github.com/ossf/scorecard/actions/runs/1862557909)

[github-actions]

Integration tests success for
[9cf9041]
(https://github.com/ossf/scorecard/actions/runs/1867624729)

[github-actions]

Integration tests success for
[659ca06]
(https://github.com/ossf/scorecard/actions/runs/1873097641)

[azeemshaikh38]

Looks good to me. Will also wait for @laurentsimon's approval.

[github-actions]

Integration tests success for
[e346208]
(https://github.com/ossf/scorecard/actions/runs/1896909121)

[laurentsimon]

Thanks Chris!

[github-actions]

Integration tests success for
[83b8194]
(https://github.com/ossf/scorecard/actions/runs/1901127011)