From 765c4328cb3de2474dd7d37cd959fc1d7813c9c8 Mon Sep 17 00:00:00 2001
From: Rich Harris <richard.a.harris@gmail.com>
Date: Mon, 27 Nov 2023 17:10:31 -0500
Subject: [PATCH 1/4] Update packages/svelte/src/main/ambient.d.ts

---
 packages/svelte/src/main/ambient.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/svelte/src/main/ambient.d.ts b/packages/svelte/src/main/ambient.d.ts
index 61cfadc8a1..6cfb48aec7 100644
--- a/packages/svelte/src/main/ambient.d.ts
+++ b/packages/svelte/src/main/ambient.d.ts
@@ -168,7 +168,7 @@ declare namespace $log {
 	export function trace(): void;
 
 	/**
-	 * Deeply tracks and `console.table`s any values passed to the rune. Example:
+	 * Logs the arguments with `console.table` whenever they change. Example:
 	 *
 	 * ```ts
 	 * $log.table(someDataCollection)

From 376fc50fdac2deb9f698f570f560fbfe36eeea8a Mon Sep 17 00:00:00 2001
From: Rich Harris <richard.a.harris@gmail.com>
Date: Mon, 27 Nov 2023 17:10:42 -0500
Subject: [PATCH 2/4] Update .changeset/chatty-hotels-grin.md

---
 .changeset/chatty-hotels-grin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.changeset/chatty-hotels-grin.md b/.changeset/chatty-hotels-grin.md
index f72fd33beb..d31b9d35dc 100644
--- a/.changeset/chatty-hotels-grin.md
+++ b/.changeset/chatty-hotels-grin.md
@@ -2,4 +2,4 @@
 'svelte': patch
 ---
 
-feat: adds $log rune
+feat: add $log rune

From 93a26078002a03527a24d29dd2d26dc88c5ca0d4 Mon Sep 17 00:00:00 2001
From: Dominic Gannaway <trueadm@users.noreply.github.com>
Date: Mon, 27 Nov 2023 22:14:42 +0000
Subject: [PATCH 3/4] Update
 sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md

Co-authored-by: Rich Harris <richard.a.harris@gmail.com>
---
 .../src/routes/docs/content/01-api/02-runes.md               | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md b/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md
index 84b71e7d6e..1f07f07188 100644
--- a/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md
+++ b/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md
@@ -313,9 +313,8 @@ This works just like `$log`, but triggers `console.table` instead of `console.lo
 
 ## `$log.trace`
 
-This works just like `$log`, but in addition to logging the values, it will also trace
-any mutations to fine-grain reactive state and log the sourcecode location to help find
-the cause for something changing.
+This works just like `$log`, but in addition to logging the values themselves it will pinpoint the
+line of code that triggered the update.
 
 ```svelte
 <script>

From 6b2d26712768397d9b2cab210fe508ceddbed4ee Mon Sep 17 00:00:00 2001
From: Dominic Gannaway <trueadm@users.noreply.github.com>
Date: Mon, 27 Nov 2023 22:14:52 +0000
Subject: [PATCH 4/4] Update
 sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md

Co-authored-by: Rich Harris <richard.a.harris@gmail.com>
---
 .../src/routes/docs/content/01-api/02-runes.md              | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md b/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md
index 1f07f07188..279273e79c 100644
--- a/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md
+++ b/sites/svelte-5-preview/src/routes/docs/content/01-api/02-runes.md
@@ -267,9 +267,9 @@ export default {
 
 ## `$log`
 
-The `$log` rune is roughly equivalent to `console.log`, with the exception that when anything passed to the
-rune changes, the latest values will be logged out. `$log` tracks reactive state deeply, meaning that mutating
-something from with an object or array using fine-grain reactivity will be tracked.
+The `$log` rune is roughly equivalent to `console.log`, with the exception that it will re-run whenever the
+arguments change. `$log` tracks reactive state deeply, meaning that updating something inside an object
+or array using [fine-grained reactivity](/docs/fine-grained-reactivity) will update the logs.
 
 ```svelte
 <script>