From b8a9f8e1b0943200796f69d7916204077dd89795 Mon Sep 17 00:00:00 2001
From: Marvin Hagemeister <marvin@marvinhagemeister.de>
Date: Thu, 1 Aug 2019 07:31:07 +0200
Subject: [PATCH] Add meta description for seo

---
 .prettierignore                               |  1 +
 content/about/browser-support.md              |  1 +
 content/about/cli.md                          |  1 +
 content/about/demos-examples.md               |  1 +
 content/about/libraries-addons.md             |  1 +
 content/about/project-goals.md                |  1 +
 content/about/we-are-using.md                 |  1 +
 content/guide/v10/api-reference.md            |  1 +
 content/guide/v10/components.md               |  1 +
 content/guide/v10/context.md                  |  1 +
 content/guide/v10/debugging.md                |  1 +
 content/guide/v10/differences-to-react.md     |  1 +
 content/guide/v10/external-dom-mutations.md   |  1 +
 content/guide/v10/forms.md                    |  1 +
 content/guide/v10/getting-started.md          |  1 +
 content/guide/v10/hooks.md                    |  1 +
 content/guide/v10/progressive-web-apps.md     |  1 +
 content/guide/v10/refs.md                     |  1 +
 content/guide/v10/server-side-rendering.md    |  1 +
 content/guide/v10/switching-to-preact.md      |  1 +
 content/guide/v10/tutorial.md                 |  1 +
 content/guide/v10/unit-testing-with-enzyme.md |  1 +
 content/guide/v10/upgrade-guide.md            |  1 +
 content/guide/v10/web-components.md           |  1 +
 content/index.md                              |  1 +
 src/components/controllers/page/index.js      | 28 +++++++++++++------
 src/template.html                             |  1 +
 27 files changed, 46 insertions(+), 8 deletions(-)

diff --git a/.prettierignore b/.prettierignore
index 31f0f9cb0..c6bc6d83d 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -1,3 +1,4 @@
 package.json
 content/
 prism.js
+template.html
diff --git a/content/about/browser-support.md b/content/about/browser-support.md
index 892862669..0bac3b030 100755
--- a/content/about/browser-support.md
+++ b/content/about/browser-support.md
@@ -1,6 +1,7 @@
 ---
 name: Browser Support
 permalink: '/about/browser-support'
+description: "Preact supports all modern browsers (Chrome, Firefox, Safari, Edge) and IE11 out of the box."
 ---
 
 # Browser Support
diff --git a/content/about/cli.md b/content/about/cli.md
index a04b779bb..76247f6dd 100644
--- a/content/about/cli.md
+++ b/content/about/cli.md
@@ -1,6 +1,7 @@
 ---
 name: Preact CLI
 permalink: '/about/cli'
+description: 'Learn how to use preact-cli with Preact to speed up your development workflow'
 ---
 
 # Preact CLI
diff --git a/content/about/demos-examples.md b/content/about/demos-examples.md
index fb1753c54..abae55973 100755
--- a/content/about/demos-examples.md
+++ b/content/about/demos-examples.md
@@ -1,6 +1,7 @@
 ---
 name: Demos & Examples
 permalink: '/about/demos-examples'
+description: 'Collection of demos and example Preact applications'
 ---
 
 # Demos & Examples
diff --git a/content/about/libraries-addons.md b/content/about/libraries-addons.md
index c691338b0..77c94232e 100755
--- a/content/about/libraries-addons.md
+++ b/content/about/libraries-addons.md
@@ -1,6 +1,7 @@
 ---
 name: Libraries & Add-ons
 permalink: '/about/addons-libraries'
+description: 'Collection of libraries and addons that work well with Preact'
 ---
 
 # Libraries & Add-ons
diff --git a/content/about/project-goals.md b/content/about/project-goals.md
index 2f32615bc..1daee50ae 100755
--- a/content/about/project-goals.md
+++ b/content/about/project-goals.md
@@ -1,6 +1,7 @@
 ---
 name: Project Goals
 permalink: '/about/project-goals'
+description: 'Read more about Preact's project goals'
 ---
 
 # Preact's Goals
diff --git a/content/about/we-are-using.md b/content/about/we-are-using.md
index b3f30511c..63140d454 100755
--- a/content/about/we-are-using.md
+++ b/content/about/we-are-using.md
@@ -2,6 +2,7 @@
 name: We Are Using
 title: Who's using Preact?
 permalink: '/about/we-are-using'
+description: 'Companies who are proudly using Preact'
 ---
 
 <style>
diff --git a/content/guide/v10/api-reference.md b/content/guide/v10/api-reference.md
index be7e52e70..0892bc213 100644
--- a/content/guide/v10/api-reference.md
+++ b/content/guide/v10/api-reference.md
@@ -1,5 +1,6 @@
 ---
 name: API Reference
+description: 'Learn more about all exported functions of the Preact module'
 ---
 
 # API Reference <!-- omit in toc -->
diff --git a/content/guide/v10/components.md b/content/guide/v10/components.md
index 9fc416ef0..64f5aeb52 100755
--- a/content/guide/v10/components.md
+++ b/content/guide/v10/components.md
@@ -1,5 +1,6 @@
 ---
 name: Components
+descriptions: 'Components are the heart of any Preact application. Learn how to create them and use them to compose UIs together'
 ---
 
 # Components <!-- omit in toc -->
diff --git a/content/guide/v10/context.md b/content/guide/v10/context.md
index 5af35dd44..6394af878 100644
--- a/content/guide/v10/context.md
+++ b/content/guide/v10/context.md
@@ -1,5 +1,6 @@
 ---
 name: Context
+description: 'Context allows you to pass props through intermediate components. This documents describes both the new and the old API'
 ---
 
 # Context<!-- omit in toc -->
diff --git a/content/guide/v10/debugging.md b/content/guide/v10/debugging.md
index 514dbc43a..d0a17031f 100644
--- a/content/guide/v10/debugging.md
+++ b/content/guide/v10/debugging.md
@@ -1,5 +1,6 @@
 ---
 name: Debugging Preact Apps
+description: 'How to debug Preact applications when something goes wrong.'
 ---
 
 # Debugging Preact Apps <!-- omit in toc -->
diff --git a/content/guide/v10/differences-to-react.md b/content/guide/v10/differences-to-react.md
index 05ca7bf88..44802cb90 100755
--- a/content/guide/v10/differences-to-react.md
+++ b/content/guide/v10/differences-to-react.md
@@ -1,6 +1,7 @@
 ---
 name: Differences to React
 permalink: '/guide/differences-to-react'
+description: 'What are the differences between Preact and React. This document describes them in detail'
 ---
 
 # Differences to React <!-- omit in toc -->
diff --git a/content/guide/v10/external-dom-mutations.md b/content/guide/v10/external-dom-mutations.md
index e4e0027bb..fc3a19b8d 100755
--- a/content/guide/v10/external-dom-mutations.md
+++ b/content/guide/v10/external-dom-mutations.md
@@ -1,6 +1,7 @@
 ---
 name: External DOM Mutations
 permalink: '/guide/external-dom-mutations'
+description: 'How to integrate Preact with jQuery and other JavaScript snippets which mutate the DOM directly'
 ---
 
 # External DOM Mutations <!-- omit in toc -->
diff --git a/content/guide/v10/forms.md b/content/guide/v10/forms.md
index 48a26dd67..4afed94b1 100755
--- a/content/guide/v10/forms.md
+++ b/content/guide/v10/forms.md
@@ -1,5 +1,6 @@
 ---
 name: Forms
+description: 'How to build awesome forms in Preact that work anywhere.'
 ---
 
 # Forms <!-- omit in toc -->
diff --git a/content/guide/v10/getting-started.md b/content/guide/v10/getting-started.md
index 32ef024e2..3f19af834 100644
--- a/content/guide/v10/getting-started.md
+++ b/content/guide/v10/getting-started.md
@@ -1,5 +1,6 @@
 ---
 name: Getting Started
+description: 'How to get started with Preact. We'll learn how to setup the tooling (if any) and get going with writing an application.'
 ---
 
 # Getting Started <!-- omit in toc -->
diff --git a/content/guide/v10/hooks.md b/content/guide/v10/hooks.md
index 886524d45..1989e8aa0 100644
--- a/content/guide/v10/hooks.md
+++ b/content/guide/v10/hooks.md
@@ -1,5 +1,6 @@
 ---
 name: Hooks
+description: 'Hooks in Preact allow you to compose behaviours together and re-use that logic in different components.'
 ---
 
 # Hooks <!-- omit in toc -->
diff --git a/content/guide/v10/progressive-web-apps.md b/content/guide/v10/progressive-web-apps.md
index c123a6a30..dc2e4bfd3 100644
--- a/content/guide/v10/progressive-web-apps.md
+++ b/content/guide/v10/progressive-web-apps.md
@@ -1,6 +1,7 @@
 ---
 name: Progressive Web Apps
 permalink: '/guide/progressive-web-apps'
+description: 'Progressive Web Apps (PWA) allow you to ship your app offline. They work pretty well with Preact'
 ---
 
 # Progressive Web Apps<!-- omit in toc -->
diff --git a/content/guide/v10/refs.md b/content/guide/v10/refs.md
index f13c2b7bd..7597c163f 100644
--- a/content/guide/v10/refs.md
+++ b/content/guide/v10/refs.md
@@ -1,5 +1,6 @@
 ---
 name: References
+description: 'References can be used to access raw DOM nodes that Preact has rendered'
 ---
 
 # References<!-- omit in toc -->
diff --git a/content/guide/v10/server-side-rendering.md b/content/guide/v10/server-side-rendering.md
index 51e7b8b94..34792c814 100644
--- a/content/guide/v10/server-side-rendering.md
+++ b/content/guide/v10/server-side-rendering.md
@@ -1,5 +1,6 @@
 ---
 name: Server-Side Rendering
+description: 'Render your Preact application on the server to show content to users quicker.'
 ---
 
 # Server-Side Rendering<!-- omit in toc -->
diff --git a/content/guide/v10/switching-to-preact.md b/content/guide/v10/switching-to-preact.md
index ebdbc7e09..d3d40ab89 100755
--- a/content/guide/v10/switching-to-preact.md
+++ b/content/guide/v10/switching-to-preact.md
@@ -1,6 +1,7 @@
 ---
 name: Switching to Preact from React
 permalink: '/guide/switching-to-preact'
+description: 'Everything you need to know to switch from React to Preact.'
 ---
 
 # Switching to Preact (from React)<!-- omit in toc -->
diff --git a/content/guide/v10/tutorial.md b/content/guide/v10/tutorial.md
index 79b92a10b..b22bcc359 100755
--- a/content/guide/v10/tutorial.md
+++ b/content/guide/v10/tutorial.md
@@ -1,5 +1,6 @@
 ---
 name: Tutorial
+description: 'Write your first Preact application'
 ---
 
 # Tutorial<!-- omit in toc -->
diff --git a/content/guide/v10/unit-testing-with-enzyme.md b/content/guide/v10/unit-testing-with-enzyme.md
index 4ace91581..4aad00978 100644
--- a/content/guide/v10/unit-testing-with-enzyme.md
+++ b/content/guide/v10/unit-testing-with-enzyme.md
@@ -1,6 +1,7 @@
 ---
 name: Unit Testing with Enzyme
 permalink: '/guide/unit-testing-with-enzyme'
+description: 'Testing Preact applications made easy with enzyme'
 ---
 
 # Unit Testing with Enzyme<!-- omit in toc -->
diff --git a/content/guide/v10/upgrade-guide.md b/content/guide/v10/upgrade-guide.md
index 37b346e2b..b1dd5e8a3 100644
--- a/content/guide/v10/upgrade-guide.md
+++ b/content/guide/v10/upgrade-guide.md
@@ -1,5 +1,6 @@
 ---
 name: Upgrading from Preact 8.x
+description: 'Upgrade your Preact 8.x application to Preact X'
 ---
 
 # Upgrading from Preact 8.x <!-- omit in toc -->
diff --git a/content/guide/v10/web-components.md b/content/guide/v10/web-components.md
index 31a55b37b..f556eedc7 100644
--- a/content/guide/v10/web-components.md
+++ b/content/guide/v10/web-components.md
@@ -1,5 +1,6 @@
 ---
 name: Web Components
+description: 'How to use webcomponents with Preact.'
 ---
 
 # Web Components<!-- omit in toc -->
diff --git a/content/index.md b/content/index.md
index 173129012..c98e3814a 100755
--- a/content/index.md
+++ b/content/index.md
@@ -3,6 +3,7 @@ layout: home
 title: Preact
 show_title: false
 toc: false
+description: 'Preact is a fast 3kB alternative to React with the same modern API'
 ---
 
 <jumbotron>
diff --git a/src/components/controllers/page/index.js b/src/components/controllers/page/index.js
index 64be66dd1..388c8c216 100644
--- a/src/components/controllers/page/index.js
+++ b/src/components/controllers/page/index.js
@@ -8,7 +8,10 @@ import Footer from '../../footer';
 import Sidebar from './sidebar';
 import Hydrator from '../../../lib/hydrator';
 import EditThisPage from '../../edit-button';
-import { getPrerenderData, InjectPrerenderData } from '../../../lib/prerender-data';
+import {
+	getPrerenderData,
+	InjectPrerenderData
+} from '../../../lib/prerender-data';
 import { isDocPage } from '../../../lib/docs';
 import { useStore } from '../../store-adapter';
 
@@ -26,8 +29,20 @@ export function useTitle(title) {
 	}, [title]);
 }
 
-const noop = () => {};
+/**
+ * Set the meta description tag content
+ * @param {string} text
+ */
+export function useDescription(text) {
+	useEffect(() => {
+		const el = document.querySelector('meta[name=description]');
+		if (text && el) {
+			el.setAttribute('content', text);
+		}
+	}, [text]);
+}
 
+const noop = () => {};
 
 export function usePage(route) {
 	// on the server, pass data down through the tree to avoid repeated FS lookups
@@ -43,7 +58,7 @@ export function usePage(route) {
 	}
 
 	const [current, setCurrent] = useState(getContent(route));
-	
+
 	const bootData = getPrerenderData(current);
 
 	const [hydrated, setHydrated] = useState(!!bootData);
@@ -60,6 +75,7 @@ export function usePage(route) {
 	}, [getContent(route)]);
 
 	useTitle(meta.title);
+	useDescription(meta.description);
 
 	let didLoad = false;
 	function onLoad({ meta }) {
@@ -130,11 +146,7 @@ export default function Page({ route }) {
 					toc={toc}
 				/>
 				<div class={style.inner}>
-					<Hydrator
-						boot={isReady}
-						component={EditThisPage}
-						show={canEdit}
-					/>
+					<Hydrator boot={isReady} component={EditThisPage} show={canEdit} />
 					<Hydrator
 						component={Title}
 						boot={isReady}
diff --git a/src/template.html b/src/template.html
index 642775251..f71146a46 100644
--- a/src/template.html
+++ b/src/template.html
@@ -7,6 +7,7 @@
 		<meta name="mobile-web-app-capable" content="yes">
 		<meta name="apple-mobile-web-app-capable" content="yes">
 		<link rel="manifest" href="<%= htmlWebpackPlugin.files.publicPath %>manifest.json">
+		<meta name="description" content="Preact is a fast 3kB alternative to React with the same modern API.">
 		<% if (htmlWebpackPlugin.options.manifest.theme_color) { %>
 			<meta name="theme-color" content="<%= htmlWebpackPlugin.options.manifest.theme_color %>">
 		<% } %>