wip

docs/concepts/account-linking/child-accounts.mdx

@@ -14,10 +14,10 @@ broader status quo of Web2 identity authentication and single-click onboarding f
 In this doc, we’ll dive into a progressive onboarding flow, including the Cadence scripts & transactions that go into
 its implementation in your dApp. These components will enable any implementing dApp to create a custodial account,
 mediate the user’s on-chain actions on their behalf, and later delegate access of that dApp-created account to the
-user’s wallet. We’ll refer to this custodial pattern as the Hybrid Account Model and the process of delegating control
+user’s wallet. We’ll refer to this custodial pattern as the Hybrid Custody Model and the process of delegating control
 of the dApp account as Account Linking.
 
-# Objectives
+In this guide we'll cover:
 
 - Create a [walletless onboarding](https://flow.com/post/flow-blockchain-mainstream-adoption-easy-onboarding-wallets)
   transaction
@@ -28,7 +28,7 @@ of the dApp account as Account Linking.
   wallet-mediated “parent” account and any hybrid custody model “child” accounts
 - Facilitate transactions acting on assets in child accounts
 
-## Walletless Onboarding
+## Step 1 : Walletless Onboarding
 
 Walletless onboarding is an approach through which developers can meet new users where they are in their Web3 journey,
 delivering a familiar experience while progressively exposing new users to the benefits of Web3. On Flow, developers can

docs/concepts/account-linking/index.mdx

@@ -3,17 +3,17 @@ title: Account Linking
 sidebar_position: 9
 ---
 
-# Account Linking Overview
+# Overview
 
 The Account Linking feature on Flow enables developers to provide seamless onboarding and in-app experiences while
 simultaneously empowering users with real ownership and self-sovereignty. With this [new custodial
 model](https://forum.onflow.org/t/hybrid-custody/4016), developers can deliver the benefits of both app and self-custody
 in a unified experience.
 
-The full Account Linking experience is enabled by three core components:
+The full user experience is enabled by three core components:
 - Walletless Onboarding - App managed account creation, funding, and custody
 - Account Linking - App custodied accounts may delegate access to users wallet
-- Core `HybridCustody` contract - A standard contract enabling users to view and manage their linked accounts from the parent account
+- Core `HybridCustody` contract - A standard contract enabling users to view and manage their linked accounts
 
 
 <Callout type="warning">
@@ -25,7 +25,7 @@ contributing? [Check out the source!](https://github.com/onflow/hybrid-custody).
 
 </Callout>
 
-### The Path to Hybrid Custody with Account Linking
+### User Journey
 
 1. The app creates, funds, and manages access to a Flow account initialized on user onboarding. This enables the app to
    abstract away the complexities of interacting with smart contract powered applications, and focus on creating slick
@@ -54,7 +54,7 @@ user in a frictionless UX free from transaction prompts.
 
 <Callout type="success">
 
-All assets in the app account can now jump the walled garden to play in the rest of the Flow ecosystem. No transactions are needed to move assets from the child account to the parent, as the parent account already has full access to the assets in the child account.
+All assets in the app account can now jump the walled garden to play in the rest of the Flow ecosystem. No transactions are needed to move assets from the child account to the parent account, as the parent account already has full access to the assets in the child account.
 
 </Callout>
 
@@ -67,4 +67,12 @@ making it seamless to continue using the original app while also using other app
 
 With account linking, developers can build walletless onboarding experiences for new users that provide a clear path to
 self-custody. Continue on to read our guides for more details on how you can use Account Linking to
-build spectacular experiences on Flow.
+build spectacular experiences on Flow.
+
+### Guides
+
+- [Managing Child Accounts](./child-accounts.mdx) covers how dapps can leverage Account Linking to create a seamless user
+experience and enable future self-custody.
+- [Working With Parent Accounts](./child-accounts.mdx) covers features enabled by the core `HybridCustody` contract to
+access child account assets from parent accounts. This is useful for apps like marketplaces or wallets that are working with
+accounts that have potential child accounts.

docs/concepts/account-linking/parent-accounts.mdx

@@ -1,5 +1,5 @@
 ---
-title: Working with Parent Accounts
+title: Working With Parent Accounts
 sidebar_position: 2
 ---