diff --git a/frontend/src/lib/components/home/WorkspaceEmptyState.svelte b/frontend/src/lib/components/home/WorkspaceEmptyState.svelte
index 0dc547f2cb..ff17e36737 100644
--- a/frontend/src/lib/components/home/WorkspaceEmptyState.svelte
+++ b/frontend/src/lib/components/home/WorkspaceEmptyState.svelte
@@ -101,7 +101,11 @@
 		or
 		<CreateActionsMenu source="empty_state" triggerElement={newLinkEl}>
 			{#snippet trigger()}
-				<!-- The full stop rides inside the snippet: across a component boundary Svelte
+				<!-- 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.
+				     The colour is `text-accent` — the `text-blue-500` older links use is the
+				     mistake to avoid, not the pattern to copy.
+				     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}
diff --git a/frontend/src/lib/components/workspaceSettings/SimpleCreateWorkspace.svelte b/frontend/src/lib/components/workspaceSettings/SimpleCreateWorkspace.svelte
index 7e79f9e838..b216076b46 100644
--- a/frontend/src/lib/components/workspaceSettings/SimpleCreateWorkspace.svelte
+++ b/frontend/src/lib/components/workspaceSettings/SimpleCreateWorkspace.svelte
@@ -158,6 +158,8 @@
 		{/if}
 
 		<div class="mt-6 flex items-center justify-between gap-4">
+			<!-- A bare <button> as a quiet text link, signed off by design: a second <Button> here
+			     would compete with Create workspace for the eye. -->
 			<button class="text-xs text-secondary hover:text-emphasis" onclick={() => (advanced = true)}>
 				Advanced settings
 			</button>
diff --git a/frontend/src/routes/(root)/(logged)/user/(user)/workspaces/+page.svelte b/frontend/src/routes/(root)/(logged)/user/(user)/workspaces/+page.svelte
index a76fe6037b..6066cd7263 100644
--- a/frontend/src/routes/(root)/(logged)/user/(user)/workspaces/+page.svelte
+++ b/frontend/src/routes/(root)/(logged)/user/(user)/workspaces/+page.svelte
@@ -238,7 +238,10 @@
 			<span class="text-xs text-tertiary">
 				Logged in as <span class="text-secondary">{$usersWorkspaceStore?.email}</span>
 				·
-				<button class="text-blue-500 hover:underline" onclick={() => logout()}>Log out</button>
+				<!-- A bare <button> for a link inside the sentence, signed off by design: <Button>
+				     cannot sit inline in running text. `text-accent`, not the `text-blue-500` of
+				     older links. -->
+				<button class="text-accent hover:underline" onclick={() => logout()}>Log out</button>
 			</span>
 		{/if}
 	{/snippet}