feat: Dedicated release note for dropping repository permissions for Administration on GitHub

[claudiacarpinteiro]

Adds a dedicated release note page explaining that Codacy GitHub App no longer requests read and write repository permissions for Administration and what users need to do.

👀 Live preview

https://pluto-802-gh-access-tokens-release--docs-codacy.netlify.app/release-notes/cloud/cloud-2024-01-15-gh-repository-ssh-keys-discontinuation/

🚧 To do

• Request validation
• Apply feedback
• Wait for communication date

[github-actions]

Overall readability score: 54.2 (🔴 -0.05)

File	Readability
which-permissions-does-codacy-need-from-my-account.md	57.15 (🟢 +0.14)
cloud-2024-01-15-gh-repository-ssh-keys-discontinuation.md	46.42 (-)
index.md	72.83 (🔴 -2.92)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
which-permissions-does-codacy-need-from-my-account.md	57.15	35.98	10.72	12	11.95	7.1
	🟢 +0.14	🟢 +0.3	🟢 +0.12	🟢 +0	🔴 -0.17	🟢 +0.04
cloud-2024-01-15-gh-repository-ssh-keys-discontinuation.md	46.42	26.91	11.26	14.3	14.33	7.6
	-	-	-	-	-	-
index.md	72.83	87.76	9.13	12.9	9.68	6.32
	🔴 -2.92	🔴 -8.96	🔴 -0.35	🔴 -0.3	🔴 -0.17	🔴 -0.05

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	54.2	42.97	10.86	12.38	12.54	7.87
	🔴 -0.05	🔴 -0.13	🟢 +0	🔴 -0.01	🔴 -0.01	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[RaquelHipolito]

@claudiacarpinteiro I left some suggestions, feel free to action what makes sense.
One general thought, there's no mention of who can action the change requested - admin, everyone, etc?

[claudiacarpinteiro]

@claudiacarpinteiro I left some suggestions, feel free to action what makes sense.

Thank you for the feedback, @RaquelHipolito! I updated accordingly. 👍

One general thought, there's no mention of who can action the change requested - admin, everyone, etc?

Good question! 🤔
@andrzej-janczak @lorandszakacs Maybe you can help here... Which role must approve Codacy GitHub App updated permissions? Must all users perform this action, or only Organization owners?

[andrzej-janczak]

#1971 (comment)
Only Admin can accept new permissions

[andrzej-janczak]

looks great 💯

[jorgebraz]

In general looks good to me, all my feedback is related to "present" VS "future" and what the semantics words like "deprecated".
Let me know if the comments were clear or let's sync and commit.

[claudiacarpinteiro]

@jorgebraz @andrzej-janczak Thank you for your input. 🙏
I incorporated your feedback. Let me know if it's ok.

[RaquelHipolito]

@claudiacarpinteiro @jorgebraz Left some comments. 🙏