From de5584844bba35ccb57c4ba4dc4fbc91bb1f362c Mon Sep 17 00:00:00 2001
From: Guilhem Lemouel <guilhemlemouel@gmail.com>
Date: Tue, 8 Sep 2026 12:07:41 +0200
Subject: [PATCH] docs(frontend): put the inline-link rationale on the first
 link, not the third
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The caption's three links share one reason for being bare `<button>`s, and it
was written on the last of them. A reader — or a reviewer — meets the archived
one first.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JirHCYVR6qg7Xqe4PcZ1KG
---
 .../src/lib/components/home/WorkspaceEmptyState.svelte | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/frontend/src/lib/components/home/WorkspaceEmptyState.svelte b/frontend/src/lib/components/home/WorkspaceEmptyState.svelte
index ce960925eb..fc36cc334b 100644
--- a/frontend/src/lib/components/home/WorkspaceEmptyState.svelte
+++ b/frontend/src/lib/components/home/WorkspaceEmptyState.svelte
@@ -78,7 +78,10 @@
 	>
 		{#if archivedOnly}
 			<!-- Its own line: the state and the invitation are two sentences, and splicing them
-			     into one leaves a link doing the work of a conjunction. -->
+			     into one leaves a link doing the work of a conjunction.
+			     Every link in this caption is a bare <button>, signed off by design: <Button>
+			     carries its own padding and background and cannot sit inline in running text.
+			     They take `text-accent`, never a raw Tailwind blue. -->
 			<span class="block">
 				Everything in this workspace is archived.
 				<button
@@ -129,10 +132,7 @@
 			{/if}
 			<CreateActionsMenu source="empty_state" triggerElement={newLinkEl}>
 				{#snippet trigger()}
-					<!-- A bare <button> for a link inside a sentence, signed off by design: <Button>
-				     carries its own padding and background and cannot sit inline in running text.
-				     Inline links take `text-accent`, never a raw Tailwind blue.
-				     The full stop rides inside the snippet: across a component boundary Svelte
+					<!-- The full stop rides inside the snippet: across a component boundary Svelte
 				     keeps the markup whitespace, which would leave a gap before it. -->
 					<button
 						bind:this={newLinkEl}