Add intros

documentation/docs/02-template-syntax/02-basic-markup.md

@@ -2,6 +2,8 @@
 title: Basic markup
 ---
 
+Basics of svelte's template syntax. These are smallest building blocks of [svelte components](./svelte-components).
+
 ## Tags
 
 A lowercase tag, like `<div>`, denotes a regular HTML element. A capitalised tag, such as `<Widget>` or `<Namespace.Widget>`, indicates a _component_.

documentation/docs/02-template-syntax/03-logic-blocks.md

@@ -2,6 +2,8 @@
 title: Logic blocks
 ---
 
+HTML doesn't have a way of expressing logic, like conditionals and loops. Svelte does. It uses special tags `{#if}`, `{#each}` and `{#await}` to add logic to your markup.
+
 ## {#if ...}
 
 ```svelte

documentation/docs/02-template-syntax/04-special-tags.md

@@ -2,6 +2,8 @@
 title: Special tags
 ---
 
+These are special tags to add logic to your markup, inline.
+
 ## {@html ...}
 
 ```svelte

documentation/docs/02-template-syntax/06-component-directives.md

@@ -2,6 +2,8 @@
 title: Component directives
 ---
 
+Directives supported on invoking components. These allow listening to events, binding to props, and more.
+
 ## on:_eventname_
 
 ```svelte

documentation/docs/02-template-syntax/07-special-elements.md

@@ -2,6 +2,8 @@
 title: Special elements
 ---
 
+Svelte provides a variety of built-in elements. These are not part of the DOM, but are instead handled by the compiler, and ease the process of working with higher level DOM elements easier, alongside providing instructions to the compiler.
+
 ## `<slot>`
 
 ```svelte

documentation/docs/04-compiler-and-api/02-client-side-component-api.md

@@ -2,6 +2,8 @@
 title: 'Client-side component API'
 ---
 
+Svelte provides a client-side API for interacting with components. This allows you to create components programmatically, and to access their properties and methods.
+
 ## Creating a component
 
 ```ts