From 0b2dfcdd8d2034d558c81abf1db6f3517ea16a16 Mon Sep 17 00:00:00 2001
From: Daniel Cazzulino <daniel@cazzulino.com>
Date: Thu, 26 Sep 2024 16:45:58 -0300
Subject: [PATCH] Add friendly description to pages

---
 docs/faq.md           | 11 ++++++-----
 docs/github/index.md  |  1 +
 docs/github/issues.md |  1 +
 docs/github/oss.md    |  1 +
 docs/privacy.md       |  1 +
 docs/spec.md          |  3 ++-
 6 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/docs/faq.md b/docs/faq.md
index 1b850e04..e7c93225 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -1,5 +1,6 @@
 ---
 title: FAQ
+description: Frequently Asked Questions about SponsorLink
 nav_order: 4
 page_toc: false
 ---
@@ -28,8 +29,8 @@ of the [standard manifest format](spec.md) available in the
    and subsequently requests a sponsor manifest from the sponsored accounts.
    This is NOT needed when synchronizing a specific account.
 
-4. Does the SponsorLink developer (Devlooped) get access to my profile
-   or sponsorship data when synchronizing other account's manifests?
+4. Does the SponsorLink developer ([Devlooped](https://github.com/devlooped)) get access to 
+   my profile sponsorship data when synchronizing other account's manifests?
 
    **NO.** The backend that signs manifests must be self-hosted by each sponsored 
    account that wants to leverage SponsorLink. This code is also OSS at the 
@@ -68,7 +69,7 @@ of the [standard manifest format](spec.md) available in the
     
     **YES.** Accounts you are currently sponsoring already have this information as 
     part of their profile. SponsorLink itself does not use any information they 
-    don't already have access to, and the SponsorLink developer (Devlooped) does 
-    not have access to any of this information since it doesn't offer hosting for 
-    the backend that signs manifests.
+    don't already have access to, and the SponsorLink developer 
+    ([Devlooped](https://github.com/devlooped)) does not have access to any of 
+    this information since it doesn't offer hosting for the backend that signs manifests.
 
diff --git a/docs/github/index.md b/docs/github/index.md
index 460b3a37..c56861b5 100644
--- a/docs/github/index.md
+++ b/docs/github/index.md
@@ -1,5 +1,6 @@
 ---
 title: GitHub Sponsors
+description: GitHub Sponsors Reference Implementation for SponsorLink
 nav_order: 3
 has_children: true
 has_toc: false
diff --git a/docs/github/issues.md b/docs/github/issues.md
index 6b8d408c..1000b66f 100644
--- a/docs/github/issues.md
+++ b/docs/github/issues.md
@@ -1,5 +1,6 @@
 ---
 title: Back an Issue
+description: Fund the GitHub issues that matter most to you
 parent: GitHub Sponsors
 page_toc: false
 ---
diff --git a/docs/github/oss.md b/docs/github/oss.md
index ed94f2a6..5d166882 100644
--- a/docs/github/oss.md
+++ b/docs/github/oss.md
@@ -1,5 +1,6 @@
 ---
 title: OSS Authors
+description: See your impact as a GitHub OSS author and contributor
 parent: GitHub Sponsors
 page_toc: false
 ---
diff --git a/docs/privacy.md b/docs/privacy.md
index 6fcbb582..9aa187d2 100644
--- a/docs/privacy.md
+++ b/docs/privacy.md
@@ -1,5 +1,6 @@
 ---
 title: Privacy Statement
+description: SponsorLink Privacy Statement
 nav_order: 5
 ---
 <!-- #content -->
diff --git a/docs/spec.md b/docs/spec.md
index c4d6a0ec..6fd089f4 100644
--- a/docs/spec.md
+++ b/docs/spec.md
@@ -1,5 +1,6 @@
 ---
-title: Manifest Spec 
+title: Manifest Spec
+description: SponsorLink Manifest Specification
 nav_order: 2
 has_children: true
 has_toc: false