Adding descriptions to all the guide pages

src/pages/learn/add-react-to-a-website.md

@@ -1,5 +1,6 @@
 ---
 title: Add React to a Website
+description: "How to add interactive React components to an HTML page with just a few lines of code—and no build tooling!"
 ---
 
 <Intro>

src/pages/learn/adding-interactivity.md

@@ -1,5 +1,6 @@
 ---
 title: Adding Interactivity
+description: "How to use React's useState() Hook to make interfaces interactive."
 ---
 
 <Intro>

src/pages/learn/choosing-the-state-structure.md

@@ -1,5 +1,6 @@
 ---
 title: Choosing the State Structure
+description: "Some guidelines for structuring your state among components."
 ---
 
 <Intro>

src/pages/learn/conditional-rendering.md

@@ -1,5 +1,6 @@
 ---
 title: Conditional Rendering
+description: "You can use plain JavaScript to conditionally render JSX inside React components."
 ---
 
 <Intro>

src/pages/learn/describing-the-ui.md

@@ -1,5 +1,6 @@
 ---
 title: Describing the UI
+description: "React describes user interfaces from web sites to phone apps with reusable, nestable components."
 ---
 
 <Intro>

src/pages/learn/editor-setup.md

@@ -1,5 +1,6 @@
 ---
 title: Editor Setup
+description: "How to install and configure a code editor for writing React code."
 ---
 
 <Intro>

src/pages/learn/escape-hatches.md

@@ -1,5 +1,6 @@
 ---
 title: Escape Hatches
+description: "Coming soon!"
 ---
 
 This chapter is incomplete and is still being written!

src/pages/learn/extracting-state-logic-into-a-reducer.md

@@ -1,5 +1,6 @@
 ---
 title: Extracting State Logic into a Reducer
+description: "A reducer function lets you consolidate many state updates from many event handlers into one place."
 ---
 
 <Intro>

src/pages/learn/importing-and-exporting-components.md

@@ -1,5 +1,6 @@
 ---
 title: Importing and Exporting Components
+description: "Modular React components often get spread across multiple files. To nest them, you'll need to import and export your components."
 ---
 
 <Intro>

src/pages/learn/index.md

@@ -1,5 +1,6 @@
 ---
 title: Quick Start
+description: "A succinct overview of React to get an idea of how the library works."
 ---
 
 <Intro>

src/pages/learn/installation.md

@@ -1,5 +1,6 @@
 ---
 title: Installation
+description: "Get started setting up React and your developer environment."
 ---
 
 <Intro>

src/pages/learn/javascript-in-jsx-with-curly-braces.md

@@ -1,5 +1,6 @@
 ---
 title: JavaScript in JSX with Curly Braces
+description: "Use curly braces inside your JSX to 'open a window' to JavaScript."
 ---
 
 <Intro>

src/pages/learn/keeping-components-pure.md

@@ -1,5 +1,6 @@
 ---
 title: Keeping Components Pure
+description: "Pure functions perform calculations without mutating any data. Keeping components pure will eliminate a class of bugs and behaviors from your React app."
 ---
 
 <Intro>

src/pages/learn/managing-state.md

@@ -1,5 +1,6 @@
 ---
 title: Managing State
+description: "Learn how to structure and share state between components."
 ---
 
 <Intro>

src/pages/learn/manipulating-the-dom-with-refs.md

@@ -1,5 +1,6 @@
 ---
 title: 'Manipulating the DOM with Refs'
+description: "Sometimes you need to access DOM elements managed by React. Refs can help you access a DOM node outside React."
 ---
 
 <Intro>

src/pages/learn/passing-data-deeply-with-context.md

@@ -1,5 +1,6 @@
 ---
 title: Passing Data Deeply with Context
+description: "Rather than passing props down the component tree, you can make data available to any component in a parent's component tree."
 ---
 
 <Intro>

src/pages/learn/passing-props-to-a-component.md

@@ -1,5 +1,6 @@
 ---
 title: Passing Props to a Component
+description: "Parent components pass information to child components by giving them props."
 ---
 
 <Intro>

src/pages/learn/preserving-and-resetting-state.md

@@ -1,5 +1,6 @@
 ---
 title: Preserving and Resetting State
+description: "Understand how React keeps track of what state belongs with which components so you can deliberately preserve and reset state between renders."
 ---
 
 <Intro>

src/pages/learn/queueing-a-series-of-state-updates.md

@@ -1,5 +1,6 @@
 ---
 title: Queueing a Series of State Updates
+description: "Because React batches state updates, you can pass a function to your state setting function to perform multiple operations on a state value before queuing the next render."
 ---
 
 <Intro>

src/pages/learn/react-developer-tools.md

@@ -1,5 +1,6 @@
 ---
 title: React Developer Tools
+description: "Install React DevTools in your browser to inspect and debug React components."
 ---
 
 <Intro>

src/pages/learn/reacting-to-input-with-state.md

@@ -1,5 +1,6 @@
 ---
 title: Reacting to Input with State
+description: "Use state to describe the different states your component can be in according to different user inputs."
 ---
 
 <Intro>

src/pages/learn/referencing-values-with-refs.md

@@ -1,5 +1,6 @@
 ---
 title: 'Referencing Values with Refs'
+description: "Use refs to store data between renders without triggering a render."
 ---
 
 <Intro>

src/pages/learn/render-and-commit.md

@@ -1,5 +1,6 @@
 ---
 title: Render and Commit
+description: "Understanding React's render and commit cycle is key to understanding how your component goes from JSX to the screen."
 ---
 
 <Intro>

src/pages/learn/rendering-lists.md

@@ -1,5 +1,6 @@
 ---
 title: Rendering Lists
+description: "Use JavaScript to render lists and collections of React components from arrays of data."
 ---
 
 <Intro>

src/pages/learn/responding-to-events.md

@@ -1,5 +1,6 @@
 ---
 title: Responding to Events
+description: "Event handlers are your own functions that will be triggered in response to user interactions like clicking, hovering, focusing on form inputs, and so on."
 ---
 
 <Intro>

src/pages/learn/scaling-up-with-reducer-and-context.md

@@ -1,5 +1,6 @@
 ---
 title: Scaling Up with Reducer and Context
+description:  "Combine reducers and context together to manage state of a complex screen."
 ---
 
 <Intro>

src/pages/learn/sharing-state-between-components.md

@@ -1,5 +1,6 @@
 ---
 title: Sharing State Between Components
+description: "When multiple components need access to state, "lift the state up" by moving the it to the nearest common parent."
 ---
 
 <Intro>

src/pages/learn/start-a-new-react-project.md

@@ -1,5 +1,6 @@
 ---
 title: Start a New React Project
+description: "Get started with a new React project using a framework or a toolchain."
 ---
 
 <Intro>

src/pages/learn/state-a-components-memory.md

@@ -1,5 +1,6 @@
 ---
 title: "State: A Component's Memory"
+description: "State is a piece of information a component 'remembers' between renders."
 ---
 
 <Intro>

src/pages/learn/state-as-a-snapshot.md

@@ -1,5 +1,6 @@
 ---
 title: State as a Snapshot
+description: "State variables are like a snapshot in time. Setting them triggers React to re-render the component."
 ---
 
 <Intro>

src/pages/learn/updating-arrays-in-state.md

@@ -1,5 +1,6 @@
 ---
 title: Updating Arrays in State
+description: "How to keep components pure by handling arrays used for state as though they are immutable."
 ---
 
 <Intro>

src/pages/learn/updating-objects-in-state.md

@@ -1,5 +1,6 @@
 ---
 title: Updating Objects in State
+description: "How to keep components pure by handling state objects as though they were immutable."
 ---
 
 <Intro>

src/pages/learn/writing-markup-with-jsx.md

@@ -1,5 +1,6 @@
 ---
 title: Writing Markup with JSX
+description: "JSX is a syntax extension for JavaScript that lets you write HTML-like markup inside a JavaScript file."
 ---
 
 <Intro>

src/pages/learn/your-first-component.md

@@ -1,5 +1,6 @@
 ---
 title: Your First Component
+description: "Write your first React component."
 ---
 
 <Intro>