Adds multiple pages to the Onboarding chapter

_compress_images_cache.yml

@@ -843,3 +843,76 @@ assets/images/guide/case-studies/multisig-wallet/case-current@2x.png: case-curre
 assets/images/guide/onboarding/getting-to-know-your-users/getting-to-know-your-users-preview.jpg: getting-to-know-your-users-preview.jpg
 assets/images/guide/payments/payments-preview.jpg: payments-preview.jpg
 assets/images/guide/private-key-management/private-key-management-preview.jpg: private-key-management-preview.jpg
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/verify-recovery-phrase.png: verify-recovery-phrase.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/verify-recovery-phrase@2x.png: verify-recovery-phrase@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-backup-intro.png: auto-backup-intro.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-backup-intro@2x.png: auto-backup-intro@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-select-provider.png: auto-cloud-backup-select-provider.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-select-provider@2x.png: auto-cloud-backup-select-provider@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-set-password@2x.png: auto-cloud-backup-set-password@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-set-password.png: auto-cloud-backup-set-password.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-save-password.png: auto-cloud-backup-save-password.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-save-password@2x.png: auto-cloud-backup-save-password@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-complete.png: auto-cloud-backup-complete.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/auto-cloud-backup-complete@2x.png: auto-cloud-backup-complete@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-single-word.png: copy-recovery-phrase-single-word.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-single-word@2x.png: copy-recovery-phrase-single-word@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-columns.png: copy-recovery-phrase-columns.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-columns@2x.png: copy-recovery-phrase-columns@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-reveal.png: copy-recovery-phrase-reveal.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase- reveal@2x.png: copy-recovery-phrase-
+ reveal@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-reveal@2x.png: copy-recovery-phrase-reveal@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-all-at-once.png: copy-recovery-phrase-all-at-once.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-all-at-once@2x.png: copy-recovery-phrase-all-at-once@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/confirm-recovery-phrase.png: confirm-recovery-phrase.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/confirm-recovery-phrase@2x.png: confirm-recovery-phrase@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-entry.png: copy-recovery-phrase-entry.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/copy-recovery-phrase-entry@2x.png: copy-recovery-phrase-entry@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/confirm-recovery-phrase-entry.png: confirm-recovery-phrase-entry.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/confirm-recovery-phrase-entry@2x.png: confirm-recovery-phrase-entry@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/confirm-recovery-phrase-columns.png: confirm-recovery-phrase-columns.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/manual-backup/confirm-recovery-phrase-columns@2x.png: confirm-recovery-phrase-columns@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/restoring-a-wallet/import-options.png: import-options.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/restoring-a-wallet/import-options@2x.png: import-options@2x.png
+assets/images/guide/onboarding/restoring-a-wallet/import-options@2x.png: import-options@2x.png
+assets/images/guide/onboarding/restoring-a-wallet/import-options.png: import-options.png
+assets/images/guide/onboarding/protecting-a-wallet/face-id-info.png: face-id-info.png
+assets/images/guide/onboarding/protecting-a-wallet/face-id-info@2x.png: face-id-info@2x.png
+assets/images/guide/onboarding/protecting-a-wallet/choose-pin.png: choose-pin.png
+assets/images/guide/onboarding/protecting-a-wallet/choose-pin@2x.png: choose-pin@2x.png
+assets/images/guide/onboarding/protecting-a-wallet/enter-pin.png: enter-pin.png
+assets/images/guide/onboarding/protecting-a-wallet/enter-pin@2x.png: enter-pin@2x.png
+assets/images/guide/onboarding/funding-a-wallet/buy-bitcoin.png: buy-bitcoin.png
+assets/images/guide/onboarding/funding-a-wallet/buy-bitcoin@2x.png: buy-bitcoin@2x.png
+assets/images/guide/onboarding/funding-a-wallet/redeem.png: redeem.png
+assets/images/guide/onboarding/funding-a-wallet/redeem@2x.png: redeem@2x.png
+assets/images/guide/onboarding/funding-a-wallet/rise-redeem-gift-cards@2x.png: rise-redeem-gift-cards@2x.png
+assets/images/guide/onboarding/funding-a-wallet/rise-redeem-gift-cards.png: rise-redeem-gift-cards.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-intro@2x.png: cloud-backup-intro@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-intro.png: cloud-backup-intro.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-password.png: cloud-backup-password.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-password @2x.png: cloud-backup-password
+ @2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-password@2x.png: cloud-backup-password@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-service@2x.png: cloud-backup-service@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-service.png: cloud-backup-service.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-confirmation.png: cloud-backup-confirmation.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-confirmation@2x.png: cloud-backup-confirmation@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-provider@2x.png: cloud-backup-provider@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-provider.png: cloud-backup-provider.png
+assets/images/guide/onboarding/funding-a-wallet/bitcoin-gift-cards.png: bitcoin-gift-cards.png
+assets/images/guide/onboarding/funding-a-wallet/bitcoin-gift-cards@2x.png: bitcoin-gift-cards@2x.png
+assets/images/guide/onboarding/protecting-a-wallet/hide-by-default.gif: hide-by-default.gif
+assets/images/guide/onboarding/protecting-a-wallet/hide-in-settings.gif: hide-in-settings.gif
+assets/images/guide/onboarding/protecting-a-wallet/hide-info-hidden-by-default.png: hide-info-hidden-by-default.png
+assets/images/guide/onboarding/protecting-a-wallet/reveal-by-pin-2.gif: reveal-by-pin-2.gif
+assets/images/guide/onboarding/protecting-a-wallet/hide-sensitive-information-header.png: hide-sensitive-information-header.png
+assets/images/guide/onboarding/protecting-a-wallet/hide-by-eye-icon.gif: hide-by-eye-icon.gif
+assets/images/guide/onboarding/protecting-a-wallet/hide-info-reveal-by-pin.png: hide-info-reveal-by-pin.png
+assets/images/guide/onboarding/protecting-a-wallet/hide-by-eye-icon-2.gif: hide-by-eye-icon-2.gif
+assets/images/guide/onboarding/protecting-a-wallet/reveal-by-pin.gif: reveal-by-pin.gif
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/copy-recovery-phrase.png: copy-recovery-phrase.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/copy-recovery-phrase@2x.png: copy-recovery-phrase@2x.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-PIN.png: cloud-backup-PIN.png
+assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-PIN@2x.png: cloud-backup-PIN@2x.png

guide/onboarding/automatic-cloud-backup.md

@@ -0,0 +1,108 @@
+---
+layout: guide
+title: Automatic cloud backup
+description: How to backup a recovery phrase automatically
+grand_parent: Onboarding
+parent: Backing up a recovery phrase
+nav_order: 1
+permalink: /guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/
+main_classes: -no-top-padding
+---
+
+# Automatic cloud backup
+
+### How it works
+
+The user’s key is encrypted and backed up on their respective device/cloud storage provider. If their device is lost, stolen, or broken, the user can log into their cloud storage account (such as Apple iCloud or Google Drive) to regain access to their funds. To learn more about the technical details, hop over to the [private key management]({{ '/guide/private-key-management/introduction' | relative_url }}) section on this topic.
+
+> Crypto rookies perceive themselves as “incapable of self-managing keys”.
+>
+> <cite>As researched by <a href="https://voskart.de/pdf/u_in_crypto.pdf">Abramova et al</a></cite>
+
+This method provides users with the feeling that they can rely on their cloud provider to regain access to their funds rather than putting the responsibility on themselves.
+
+Below is an example of what the user interface might look like for an automatic cloud backup that significantly reduces friction during onboarding.
+
+<div class="image-slide-gallery">
+
+{% include picture.html
+ image = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-intro.png"
+ retina = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-intro@2x.png"
+ layout = "shadow"
+ caption = "Describe to the user know what is about to happen and how it works."
+ alt-text = "Screen explaining automatic cloud backups"
+ width = 250
+ height = 541
+%}
+
+{% include picture.html
+ image = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-PIN.png"
+ retina = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-PIN@2x.png"
+ class = "shadow"
+ caption = "Allows the user to set a PIN used for authentication."
+ alt-text = "The user can set a PIN which will be used to authenticate and access the wallet"
+ width = 250
+ height = 541
+%}
+
+{% include picture.html
+ image = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-service.png"
+ retina = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-service@2x.png"
+ class = "shadow"
+ caption = "Give the user different cloud provider options, others such as Dropbox might also be included."
+ alt-text = "Screen showing saving a password to encrypt the recovery phrase"
+ width = 250
+ height = 541
+%}
+
+{% include picture.html
+ image = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-provider.png"
+ retina = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-provider@2x.png"
+ class = "shadow"
+ caption = "This UI will be very different depending on the cloud provider and what permissions are required."
+ alt-text = "Screen of placeholder where cloud provider UI would be"
+ width = 250
+ height = 541
+%}
+
+{% include picture.html
+ image = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-confirmation.png"
+ retina = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/cloud-backup-confirmation@2x.png"
+ class = "shadow"
+ caption = "Once the upload is complete it's a good idea to show a success screen and give some reassurances."
+ alt-text = "Screen showing completing a cloud backup"
+ width = 250
+ height = 541
+%}
+
+</div>
+
+### How to discuss/explain It
+
+One approach is to explicitly explain within onboarding carousels that a user’s recovery phrase is stored on the cloud; this means that if they lose or break their device, they can regain access to their funds by logging into their respective cloud account on a different device.
+
+On a similar note, it’s crucial that you also explain that if someone else knows their cloud account information, they can gain access to their funds, too.
+
+{% include tip/open.html color="green" icon="check" label="Do: Inform your Users" %}
+
+Before automatically backing up a recovery phrase via cloud backup, make sure the user knows what they are about to do. Once the backup is complete, provide a summary and some reassurances before moving on. This is a good place for loading interactions and animation because there will likely be a few seconds between when a user clicks to upload to the cloud provider and when it completes.
+
+{% include tip/close.html %}
+
+### Tradeoffs
+
+By not making users manually backup, you decrease the risk of self-inflicted loss of funds. Automatic cloud backups put less pressure and responsibility on the user.
+
+While this is an easier way for users to set up a wallet, it brings in the potential threat of malicious third-party access. If a user’s cloud account is hacked or they forget their cloud login information, their funds could be compromised.
+
+By bringing cloud storage providers into the equation, we assume that users trust their providers. This also raises the question of [decentralization]({{ 'guide/foundations/principles/#decentralization' | relative_url }}): a guiding principle of the Bitcoin space and could be considered in conflict with the popular saying, “not your keys, not your coins”.
+
+{% include tip/open.html color="red" icon="forbid" label="Don’t: Use for High Value Amounts" %}
+
+Automatic cloud backups should not be considered for products with users that are storing high-value amounts. This is because there are potentially more security threat vectors.
+
+{% include tip/close.html %}
+
+To grant users some ownership of their keys, you can create an optional manual backup within settings. A great way to do this is by framing it as an extra layer of security or a good alternative in the case that the user loses access to their cloud account/if they feel uncomfortable trusting their provider.
+
+In the next section we will show different methods for [manual backups]({{ 'guide/onboarding/backing-up-a-recovery-phrase/manual-backup' | relative_url }}).

guide/onboarding/backing-up-a-recovery-phrase.md

@@ -0,0 +1,44 @@
+---
+layout: guide
+title: Backing up a recovery phrase
+description: Handling recovery phrases during onboarding
+parent: Onboarding
+has_children: true
+nav_order: 3
+permalink: /guide/onboarding/backing-up-a-recovery-phrase/
+main_classes: -no-top-padding
+---
+
+# Backing up a recovery phrase
+
+When a user generates a new wallet, it creates something called a recovery phrase. A [recovery phrase]({{ 'guide/glossary/#recovery-phrase' | relative_url }}), is a group of 12 or 24 words that let users recover funds if wallet access is lost. Likewise, users who lose both their recovery phrase and wallet access permanently lose their bitcoin. Arguably, this creates one of the toughest design problems within the space.
+
+<div class="center" markdown="1">
+
+{% include image.html
+ image = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/copy-recovery-phrase.png"
+ retina = "/assets/images/guide/onboarding/backing-up-a-recovery-phrase/copy-recovery-phrase@2x.png"
+ width = 250
+ height = 460
+ alt-text = "Recovery phrase mobile interface"
+ caption = "Typical recovery phrase UI from the [UI Kit](https://www.figma.com/file/VB3GQdAnhl8yta44DY3PSV/Bitcoin-Wallet-UI-Kit?node-id=649%3A760)"
+ layout = "float-left-desktop -background -shadow"
+%}
+
+When new users are presented with a recovery phrase, they are often asked to write 12 or 24 words on a piece of paper and store it safely. This kind of recovery scheme can create an unfamiliar and frustrating onboarding experience. It also poses potential threats to the safety of their funds, as new users may not know how to properly store their recovery phrase, increasing their risk of losing it. It also creates a decent amount of friction, ultimately driving new users away from self-custodying their bitcoin.
+
+Regardless of the type of scheme you decide to go with, it’s crucial to be explicit about how your product is handling key management.
+
+</div>
+
+Recent [studies](https://voskart.de/pdf/bits_under_mattress.pdf) show users are often confused or unaware of where their private keys are being stored, ultimately causing inadequate risk assessment and poor storage behavior. This risk of user negligence may be avoided with transparent messaging around the scheme your wallet is using.
+
+> New-to-crypto users often expect a recovery mechanism that allows them to “regain access to their funds in the case that they lose their seed phrase.”
+>
+> <cite>As researched by <a href="https://voskart.de/pdf/bits_under_mattress.pdf">Voskobojnikov et al</a></cite>
+
+In the [private key management]({{ 'guide/private-key-management/introduction/' | relative_url }}) chapter, we recommend using an automatic cloud backup for newer users. Users can simply press a button to have their recovery phrase backed up to the cloud without having to physically write down and store it. On top of this, the onboarding process is then sped up and less cumbersome. This type of gateway gives a beginner security without overwhelming them with unfamiliar onboarding actions.
+
+However, there may be times when it is necessary to use a manual backup alternative, as it can be low tech and easily accessible.
+
+The next sections will look at some UI considerations for [automatic cloud backups]({{ '/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup' | relative_url }}) and [manual backups]({{ 'guide/onboarding/backing-up-a-recovery-phrase/manual-backup/' | relative_url }}).