From 59d42e1b2b6154dc819ad442aac48936014e92c2 Mon Sep 17 00:00:00 2001
From: Nathaniel Tucker <me@ntucker.me>
Date: Mon, 1 Jul 2024 17:13:36 +0200
Subject: [PATCH] docs: Make homepage social image use full logo

---
 docs/core/api/useSuspense.md | 32 ++++++++++++++++----------------
 website/src/pages/index.js   |  3 +++
 2 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/docs/core/api/useSuspense.md b/docs/core/api/useSuspense.md
index d55a9214c853..dedc00e6bae7 100644
--- a/docs/core/api/useSuspense.md
+++ b/docs/core/api/useSuspense.md
@@ -216,7 +216,7 @@ export const ProfileResource = createResource({
 });
 ```
 
-```tsx title="ProfileList"
+```tsx title="ProfileList"  {5}
 import { useSuspense } from '@data-client/react';
 import { ProfileResource } from './ProfileResource';
 
@@ -241,6 +241,12 @@ render(<ProfileList />);
 
 </HooksPlayground>
 
+### Pagination
+
+Reactive [pagination](/rest/guides/pagination) is achieved with [mutable schemas](/rest/api/Collection)
+
+<PaginationDemo />
+
 ### Sequential
 
 When fetch parameters depend on data from another resource.
@@ -248,11 +254,10 @@ When fetch parameters depend on data from another resource.
 ```tsx
 function PostWithAuthor() {
   const post = useSuspense(PostResource.get, { id });
-  // post as Post
   const author = useSuspense(UserResource.get, {
+    // highlight-next-line
     id: post.userId,
   });
-  // author as User
 }
 ```
 
@@ -305,12 +310,11 @@ export const UserResource = createResource({
 });
 ```
 
-```tsx title="PostWithAuthor"
+```tsx title="PostWithAuthor" {7-11}
 import { PostResource, UserResource } from './Resources';
 
 export default function PostWithAuthor({ id }: { id: string }) {
   const post = useSuspense(PostResource.get, { id });
-  // post as Post
   const author = useSuspense(
     UserResource.get,
     post.userId
@@ -332,7 +336,7 @@ When entities are stored in [nested structures](/rest/guides/relational-data#nes
 
 <TypeScriptEditor row={false}>
 
-```typescript title="api/Post"
+```typescript title="api/Post" {15-19}
 export class PaginatedPost extends Entity {
   id = '';
   title = '';
@@ -348,19 +352,19 @@ export const getPosts = new RestEndpoint({
   path: '/post',
   searchParams: { page: '' },
   schema: {
-    results: new schema.Collection([PaginatedPost]),
+    posts: new schema.Collection([PaginatedPost]),
     nextPage: '',
     lastPage: '',
   },
 });
 ```
 
-```tsx title="ArticleList"
+```tsx title="ArticleList" {5-7}
 import { getPosts } from './api/Post';
 
 export default function ArticleList({ page }: { page: string }) {
   const {
-    results: posts,
+    posts,
     nextPage,
     lastPage,
   } = useSuspense(getPosts, { page });
@@ -376,12 +380,6 @@ export default function ArticleList({ page }: { page: string }) {
 
 </TypeScriptEditor>
 
-### Pagination
-
-Reactive [pagination](/rest/guides/pagination) is achieved with [mutable schemas](/rest/api/Collection)
-
-<PaginationDemo />
-
 ### Server Side Rendering
 
 [Server Side Rendering](../guides/ssr.md) to incrementally stream HTML,
@@ -398,6 +396,8 @@ continue showing the previous screen while the new data loads. Combined with
 loading indicators - improving the user experience.
 
 Click one of the names to navigate to their todos. Here long loading states are indicated by the
-less intrusive _loading bar_, like YouTube and Robinhood use.
+less intrusive _loading bar_, like [YouTube](https://youtube.com) and [Robinhood](https://robinhood.com) use.
 
 <StackBlitz app="todo-app" file="src/pages/Home/TodoList.tsx,src/pages/Home/index.tsx,src/useNavigationState.ts" height={600} />
+
+If you need help adding this to your own custom router, check out the [official React guide](https://react.dev/reference/react/useTransition#building-a-suspense-enabled-router)
\ No newline at end of file
diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 9315d018c946..c753d87c2b7c 100644
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -1,5 +1,6 @@
 import Head from '@docusaurus/Head';
 import Link from '@docusaurus/Link';
+import { PageMetadata } from '@docusaurus/theme-common';
 import useBaseUrl from '@docusaurus/useBaseUrl';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import Layout from '@theme/Layout';
@@ -96,8 +97,10 @@ function HomepageEnder() {
 }
 
 export default function Home() {
+  const image = useBaseUrl('img/client_logo_and_text.png');
   return (
     <Layout description="Async State Management without the Management.">
+      <PageMetadata image={image} />
       <Head>
         <title>The Reactive Data Client ✨</title>
       </Head>