From f2bd77f2b0770e46f7679a740ae4e98d35f53e34 Mon Sep 17 00:00:00 2001
From: John Pedrie <john@freespoke.com>
Date: Fri, 19 Jul 2024 15:10:14 -0400
Subject: [PATCH] add page stubs and sidebar

---
 astro.config.mjs                      | 16 +++++++------
 src/content/docs/about/bias.md        | 33 +++++++++++++++++++++++++++
 src/content/docs/about/company.md     |  6 +++++
 src/content/docs/privacy/privacy.md   |  4 ++++
 src/content/docs/reference/example.md | 11 ---------
 5 files changed, 52 insertions(+), 18 deletions(-)
 create mode 100644 src/content/docs/about/bias.md
 create mode 100644 src/content/docs/about/company.md
 create mode 100644 src/content/docs/privacy/privacy.md
 delete mode 100644 src/content/docs/reference/example.md

diff --git a/astro.config.mjs b/astro.config.mjs
index 6e5d30e..0be9da3 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -4,6 +4,7 @@ import tailwind from '@astrojs/tailwind';
 
 // https://astro.build/config
 export default defineConfig({
+	site: "https://docs.freespoke.com",
 	integrations: [
 		starlight({
 			title: 'Freespoke',
@@ -13,16 +14,17 @@ export default defineConfig({
 			sidebar: [
 				'get-started',
 				{
-					label: 'Guides',
-					items: [
-						// Each item here is one entry in the navigation menu.
-						{ label: 'Example Guide', slug: 'guides/example' },
-					],
+					label: 'Freespoke Premium',
+					autogenerate: { directory: 'premium' },
 				},
 				{
-					label: 'Reference',
-					autogenerate: { directory: 'reference' },
+					label: 'About Freespoke',
+					autogenerate: { directory: 'about' },
 				},
+				{
+					label: 'Privacy',
+					autogenerate: { directory: 'privacy' },
+				}
 			],
 			customCss: ['./src/tailwind.css'],
 		}),
diff --git a/src/content/docs/about/bias.md b/src/content/docs/about/bias.md
new file mode 100644
index 0000000..225c32f
--- /dev/null
+++ b/src/content/docs/about/bias.md
@@ -0,0 +1,33 @@
+---
+title: Political Bias Ratings
+description: How Freespoke's Political Bias ratings work.
+---
+
+# Bias Ratings
+
+Freespoke provides context to your searches and our news feed by labeling
+publisher political biases. Where possible, your results will indicate whether
+the publishing website is left- or right-leaning, or whether it tends to play it
+straight with its reporting.
+
+## Sourcing
+
+We source our publisher labels from third parties such as [Ad Fontes](https://adfontesmedia.com/)
+and [AllSides](https://www.allsides.com/).
+
+## Limitations
+
+* Because our labels operate at the publisher level, we cannot account for the
+perspective of individual authors. If a liberal publisher employs a conservative
+editorial writer, our system will still label the content as left-leaning. We
+are considering more fine-grained labeling of authors or individual articles in
+the future.
+* Because we rely on third-parties for our ratings, we cannot provide
+comprehensive assessments of each and every publisher. Our sources provide solid
+coverage of popular websites, but for less well-known sites, our bias ratings
+have a lower coverage rate.
+
+Due to these limitations, you should always do your own research. Freespoke is
+a partner in your goal of understanding the varying perspectives on any topic,
+but in order to gain a truly deep understanding, each individual must still read
+and study on their own. We aim to assist in that mission.
\ No newline at end of file
diff --git a/src/content/docs/about/company.md b/src/content/docs/about/company.md
new file mode 100644
index 0000000..2427fba
--- /dev/null
+++ b/src/content/docs/about/company.md
@@ -0,0 +1,6 @@
+---
+title: History
+description: The history of Freespoke, and more about who created Freespoke.
+sidebar:
+    order: 1
+---
\ No newline at end of file
diff --git a/src/content/docs/privacy/privacy.md b/src/content/docs/privacy/privacy.md
new file mode 100644
index 0000000..66d58a9
--- /dev/null
+++ b/src/content/docs/privacy/privacy.md
@@ -0,0 +1,4 @@
+---
+title: Privacy
+description: Freespoke's privacy commitments
+---
\ No newline at end of file
diff --git a/src/content/docs/reference/example.md b/src/content/docs/reference/example.md
deleted file mode 100644
index ac8cfa8..0000000
--- a/src/content/docs/reference/example.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-title: Example Reference
-description: A reference page in my new Starlight docs site.
----
-
-Reference pages are ideal for outlining how things work in terse and clear terms.
-Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.
-
-## Further reading
-
-- Read [about reference](https://diataxis.fr/reference/) in the Diátaxis framework