small improvements

Author: ABuljko

source/components/nitrokeys/features/fido2/ssh.rst

@@ -13,6 +13,7 @@ Generating SSH Key
 2. Open a terminal and create your SSH key. Replace ``"your_comment"`` with a label to identify it (e.g., "Nitrokey GitLab").  
    By default, the key is a non-resident key, meaning a local key handle is stored in ``~/.ssh/`` while the private key remains securely on the Nitrokey.  
    Use the ``-O resident`` option if you want the key to be portable across systems.
+   For a more detailed explanation of the difference  between resident and non-resident keys, check out our :ref:`FAQ section <fido2-resident-vs-nonresident>`.
 
    .. code-block:: shell-session
 

source/components/nitrokeys/fido2/faq.rst

@@ -30,6 +30,8 @@ Nitrokey FIDO2 FAQ
 
    After `disabling Enforce Attestation <https://learn.microsoft.com/en-us/azure/active-directory/authentication/howto-authentication-passwordless-security-key#fido-security-key-optional-settings>`_ Nitrokey FIDO2 is supported by Azure Entra ID out of the box.
 
+.. _fido2-resident-difference-nonresident:
+
 .. faq:: What is the difference between Non-Resident Keys and Resident?
 
    A non-resident key (non-discoverable credential) is the default credential type created when the user registers their Nitrokey FIDO2 with an authentication system that supports FIDO2/WebAuthn.

source/components/syntax.rst

@@ -46,7 +46,7 @@ Normal text again.
 | the source file.
 
 H3 Heading
-^^^^^^^^^^
+----------
 
 
 Only the following message boxes should be used: