Documentation improvements and bugfixes

README.md

@@ -7,7 +7,7 @@
 
 ## About
 
-* `piv-agent` is an SSH and GPG agent providing simple integration of [PIV](https://csrc.nist.gov/projects/piv/piv-standards-and-supporting-documentation) hardware (e.g. a [Yubikey](https://developers.yubico.com/yubico-piv-tool/YubiKey_PIV_introduction.html)) with existing SSH and GPG workflows.
+* `piv-agent` is an SSH and GPG agent providing simple integration of [PIV](https://csrc.nist.gov/projects/piv/piv-standards-and-supporting-documentation) hardware (e.g. a [Yubikey](https://developers.yubico.com/yubico-piv-tool/YubiKey_PIV_introduction.html)) with `ssh` and `gpg` workflows such as [`git`](https://git-scm.com/) signing, [`pass`](https://www.passwordstore.org/) encryption, or [keybase](https://keybase.io/) chat.
 * `piv-agent` originated as a reimplementation of [yubikey-agent](https://github.com/FiloSottile/yubikey-agent) because I needed some extra features, and also to gain a better understanding of the PIV applet on security key hardware.
 * `piv-agent` makes heavy use of the Go standard library and supplementary `crypto` packages, as well as [`piv-go`](https://github.com/go-piv/piv-go/) and [`pcsclite`](https://pcsclite.apdu.fr/). Thanks for the great software!
 

docs/content/en/docs/_index.md

@@ -3,4 +3,3 @@ title: "PIV Agent Documentation"
 ---
 
 PIV Agent must be installed and set up to work with your hardware security device before use.
-See below for instructions.

docs/content/en/docs/faq.md

@@ -0,0 +1,30 @@
+---
+title: "FAQ"
+weight: 40
+---
+
+## How do I switch between gpg-agent and piv-agent
+
+### Linux (systemd)
+
+Stop both `gpg-agent` and `piv-agent`:
+
+{{% alert title="Note" %}}
+The `pkill` is required because `gpg` may be configured to automatically start `gpg-agent` in a manner which is not managed by `systemd`.
+{{% /alert %}}
+
+```
+systemctl --user stop gpg-agent.socket gpg-agent.service piv-agent.socket piv-agent.service; pkill gpg-agent
+```
+
+Start `piv-agent`:
+
+```
+systemctl --user start piv-agent.socket
+```
+
+Or start `gpg-agent`:
+
+```
+systemctl --user start gpg-agent.socket
+```