docs: copy

Author: neurosnap

main.go

@@ -176,14 +176,15 @@ func main() {
 				Page: pager("faq.md"),
 				Tag:  "Help",
 				Children: []*pdocs.Sitemap{
-					pdocs.AnchorTagSitemap("Permission denied when using SSH"),
+					pdocs.AnchorTagSitemap("Why can't I login to pico"),
 					pdocs.AnchorTagSitemap("How do I force the correct pico SSH key"),
-					pdocs.AnchorTagSitemap("Generating a new SSH key"),
-					pdocs.AnchorTagSitemap("Why do I provide my username when using SSH"),
+					pdocs.AnchorTagSitemap("How do I generate an SSH key"),
+					pdocs.AnchorTagSitemap("How can I setup my ssh-agent"),
 					pdocs.AnchorTagSitemap("How can I use git to sync my content"),
 					pdocs.AnchorTagSitemap("Can I create multiple pico accounts"),
 					pdocs.AnchorTagSitemap("Can I associate multiple SSH keypairs to a single account"),
 					pdocs.AnchorTagSitemap("Are there any bandwidth limitations"),
+					pdocs.AnchorTagSitemap("How can I download a copy of all of my content"),
 					pdocs.AnchorTagSitemap("How can I delete my content"),
 					pdocs.AnchorTagSitemap("How can I delete my account with my content"),
 					pdocs.AnchorTagSitemap("I lost my SSH private key how can I recover my account"),

posts/faq.md

@@ -5,27 +5,37 @@ keywords: [pico, faq, question, answer]
 toc: 1
 ---
 
-# Permission denied when using SSH
+# Why can't I login to pico?
 
 There are a couple reason why this might be happening. We require a public key
-for authentication to all of our services, so first make sure you have a valid
-SSH keypair.
+for authentication to all of our services, so first we need to make sure you
+have a valid SSH keypair and it is being sent to our SSH server.
 
 Not sure what type of keys you have? You can check with the following:
 
 ```bash
 find ~/.ssh/id_*.pub -exec ssh-keygen -l -f {} \;
 ```
 
-After that we need to determine why our server is rejecting your public key.
-What is most helpful is if you run:
+After that we need to determine why our server is not receiving your pubkey. To
+start, trying debugging with:
 
 ```bash
 ssh -vvv pico.sh
 ```
 
-If you cannot figure out what is wrong just by looking at that output, then you
-are more than welcome to join [irc](/irc) and send us a paste of the SSH logs.
+Here we are looking for the pubkeys that your SSH client is sending to us.
+
+For example, we want to see something like:
+
+```bash
+debug1: Will attempt key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent
+debug1: Offering public key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent
+debug1: Server accepts key: /home/myuser/.ssh/id_ed25519 ED25519 SHA256:XXX agent
+```
+
+If you don't see any of these log statement, it probably means you haven't
+loaded your SSH keys into your [SSH agent](#how-can-i-setup-my-ssh-agent).
 
 You should also make sure you have the correct file permissions set for your ssh
 folder and keys:
@@ -36,6 +46,9 @@ chmod 644 ~/.ssh/id_ed25519.pub
 chmod 600 ~/.ssh/id_ed25519
 ```
 
+If you cannot figure out what is wrong just by looking at that output, then you
+are more than welcome to join [irc](/irc) and send us a paste of the SSH logs.
+
 # How do I force the correct pico SSH key?
 
 There are two ways, one is when SSHing to us:
@@ -52,7 +65,7 @@ Host pico.sh pgs.sh prose.sh
   IdentityFile ~/.ssh/id_ed25519
 ```
 
-# Generating a new SSH key
+# How do I generate an SSH key?
 
 [Github Reference](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
 
@@ -63,6 +76,14 @@ ssh-keygen -t ed25519 -C "[email protected]"
 When you're prompted to "Enter a file in which to save the key," press Enter.
 This accepts the default file location. At the prompt, type a secure passphrase.
 
+# How can I setup my `ssh-agent`?
+
+your SSH agent typically hosts your SSH keypairs and serves them when
+authenticating with an SSH server. So, ensuring your `ssh-agent` is setup
+properly is important when connecting to us.
+
+[Github has a great guide on this.](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent#adding-your-ssh-key-to-the-ssh-agent)
+
 # How can I use `git` to sync my content?
 
 All you need is your private key and
@@ -100,6 +121,11 @@ So until we reach 10TB per month, there are no bandwidth limitations.
 Once we regularly reach our monthly allowance, we will have to re-evaluate our
 pricing structure.
 
+# How can I download a copy of all of my content?
+
+We will provide users with their data if they request it via
+[email](mailto:[email protected]).
+
 # How can I delete my content?
 
 [File uploads](/file-uploads#how-do-i-delete-files)
@@ -115,7 +141,7 @@ ssh pico.sh
 # Confirm delete your account
 ```
 
-# I lost my SSH private key how can I recover my account?
+# I lost my SSH private key, how can I recover my account?
 
 After account creation, we **highly** recommend users generate an
 [API Token](/api-token) and store that someplace safe. If you lose your SSH

posts/getting-started.md

@@ -19,8 +19,8 @@ To get started, simply use SSH:
 ssh pico.sh
 ```
 
-Getting `Permission denied (publickey)`?
-[Read how to fix it here](faq#permission-denied-when-using-ssh).
+Getting an error? Read our FAQ,
+[why can't I login to pico?](faq#why-cant-i-login-to-pico).
 
 All we need to create an account is your username. This username will be used
 for all of your service domains. For example, if your username is `glossy`, we