diff --git a/app/lib/firehose_web/components/core_components.ex b/app/lib/firehose_web/components/core_components.ex
index d0be6c1..cd03ca6 100644
--- a/app/lib/firehose_web/components/core_components.ex
+++ b/app/lib/firehose_web/components/core_components.ex
@@ -303,6 +303,16 @@ defmodule FirehoseWeb.CoreComponents do
     """
   end
 
+  # `table/1` and `list/1` below are part of the upstream Phoenix generator's
+  # core_components.ex and are kept available for when we need them — they are
+  # genuinely useful, not leftover scaffolding to be deleted.
+  #
+  # Nothing renders them yet: the collections that exist in the UI are hand-rolled
+  # instead (editor_dashboard_live.ex builds its drafts/scheduled rows out of
+  # bordered divs; Blogex.Components.post_index renders post previews and tag
+  # lists as articles/links). If you build a new data or admin screen, prefer
+  # these two over more bespoke markup — and if you retrofit an existing screen,
+  # drop the note here.
   @doc """
   Renders a table with generic styling.
 
@@ -366,6 +376,7 @@ defmodule FirehoseWeb.CoreComponents do
     """
   end
 
+  # Upstream scaffold, unused in-app today — see the note above `table/1`.
   @doc """
   Renders a data list.