"SSH / GPG Keys" settings point to GitHub docs instead of Codeberg #940

NeatNit commented 2023年02月15日 02:43:16 +01:00

Repeating what I mentioned on Mastodon, since I searched for older issues and found none.

Go to SSH / GPG Keys: https://codeberg.org/user/settings/keys and you'll see links to GitHub doc pages:

Need help? Have a look at GitHub's guide!

Codeberg has its own docs for these topics:

https://docs.codeberg.org/security/ssh-key/ Adding an SSH key to your account

https://docs.codeberg.org/security/gpg-key/ Adding a GPG key to your account

(There is no equivalent of GitHub's troubleshooting page, though, from what I can tell)

It would be nice if Forgejo pointed to these instead of GitHub. I looked a little deeper, and I believe the source of this text is:

https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys.tmpl the template for the entire Keys page

https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys_ssh.tmpl#L100 (permalink) the template for the SSH section, inserting the linked URLs

https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys_gpg.tmpl#L112 (permalink) the same for the GPG section

https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/options/locales/gitea_en-US.ini#L662-L663 (permalink) the localization strings, for en-US

Note, of course, that all 30 localizations would need to be updated if the links are changed.

Repeating what I mentioned [on Mastodon](https://fosstodon.org/@neatnit/109865943396657326), since I searched for older issues and found none. Go to SSH / GPG Keys: https://codeberg.org/user/settings/keys and you'll see links to GitHub doc pages:  Codeberg has its own docs for these topics: https://docs.codeberg.org/security/ssh-key/ Adding an SSH key to your account https://docs.codeberg.org/security/gpg-key/ Adding a GPG key to your account (There is no equivalent of GitHub's [troubleshooting page](https://docs.github.com/en/authentication/troubleshooting-ssh), though, from what I can tell) It would be nice if Forgejo pointed to these instead of GitHub. I looked a little deeper, and I believe the source of this text is: https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys.tmpl the template for the entire Keys page https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys_ssh.tmpl#L100 ([permalink](https://codeberg.org/Codeberg/forgejo/src/commit/1f31b235b813e58939a0b4565ab173e1f34180be/templates/user/settings/keys_ssh.tmpl#L100)) the template for the SSH section, inserting the linked URLs https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys_gpg.tmpl#L112 ([permalink](https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/templates/user/settings/keys_gpg.tmpl#L112)) the same for the GPG section https://codeberg.org/Codeberg/forgejo/src/branch/codeberg-1.18/options/locales/gitea_en-US.ini#L662-L663 ([permalink](https://codeberg.org/Codeberg/forgejo/src/commit/1f31b235b813e58939a0b4565ab173e1f34180be/options/locales/gitea_en-US.ini#L662-L663)) the localization strings, for en-US Note, of course, that all 30 localizations would need to be updated if the links are changed.

jayaddison commented 2025年09月01日 17:07:47 +02:00

NB: I think this has mostly been resolved by: Codeberg-Infrastructure/forgejo@7623dc05a9

However, there remains no equivalent of the troubleshooting / common problems hyperlink. Codeberg's documentation has a troubleshooting guide for Codeberg Pages, but not SSH/GPG issues (afaict).

NB: I think this has mostly been resolved by: https://codeberg.org/Codeberg-Infrastructure/forgejo/commit/7623dc05a9b0ba93e58ad5f4e008d1378c934cd9 However, there remains no equivalent of the troubleshooting / common problems hyperlink. Codeberg's documentation has a troubleshooting guide for Codeberg Pages, but not SSH/GPG issues (afaict).