add help links to gpg commits / gpg settings

app/assets/stylesheets/pages/commits.scss

@@ -331,3 +331,8 @@
 .gpg-badge-popover-username {
   font-weight: bold;
 }
+
+.commit .gpg-badge-popover-help-link {
+  display: block;
+  color: $link-color;
+}

app/helpers/commits_helper.rb

@@ -271,6 +271,13 @@ module CommitsHelper
       )
 
       concat "GPG key ID: #{signature.gpg_key_primary_keyid}"
+      concat(
+        link_to(
+          'Learn about signing commits',
+          help_page_path('workflow/gpg_signed_commits/index.md'),
+          class: 'gpg-badge-popover-help-link'
+        )
+      )
     end
 
     title = capture do

app/views/profiles/gpg_keys/index.html.haml

@@ -9,7 +9,10 @@
       GPG keys allow you to verify signed commits.
   .col-lg-9
     %h5.prepend-top-0
-      Add an GPG key
+      Add a GPG key
+    %p.profile-settings-content
+      Before you can add a GPG key you need to
+      = link_to 'generate it.', help_page_path('workflow/gpg_signed_commits/index.md')
     = render 'form'
     %hr
     %h5

doc/workflow/gpg_signed_commits/index.md

@@ -3,6 +3,8 @@
 ## Getting started
 
 - [Git Tools - Signing Your Work](https://git-scm.com/book/en/v2/Git-Tools-Signing-Your-Work)
+- [Git Tools - Signing Your Work: GPG introduction](https://git-scm.com/book/en/v2/Git-Tools-Signing-Your-Work#_gpg_introduction)
+- [Git Tools - Signing Your Work: Signing commits](https://git-scm.com/book/en/v2/Git-Tools-Signing-Your-Work#_signing_commits)
 
 ## How GitLab handles GPG