From 7f3cdf6c91308b43931351458acabd2d0daf371e Mon Sep 17 00:00:00 2001
From: Conduitry <git@chor.date>
Date: Fri, 25 Sep 2020 10:04:11 -0400
Subject: [PATCH] adjust docs

---
 site/content/docs/02-template-syntax.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/site/content/docs/02-template-syntax.md b/site/content/docs/02-template-syntax.md
index 10e59e8a1f..d955f650e2 100644
--- a/site/content/docs/02-template-syntax.md
+++ b/site/content/docs/02-template-syntax.md
@@ -348,11 +348,11 @@ If you don't care about the pending state, you can also omit the initial block.
 {#key expression}...{/key}
 ```
 
----
+Key blocks destroy and recreate their contents when the value of an expression changes.
 
-Key block destroys and recreates the elements when the value of the expression changes.
+---
 
-This is useful if you want to transition the element whenever the expression value changes.
+This is useful if you want an element to play its transition whenever a value changes.
 
 ```sv
 {#key value}
@@ -360,7 +360,9 @@ This is useful if you want to transition the element whenever the expression val
 {/key}
 ```
 
-Another use case is to reinitialise a Svelte component.
+---
+
+When used around components, this will cause them to be reinstantiated and reinitialised.
 
 ```sv
 {#key value}