diff --git a/crates/nu-table/README.md b/crates/nu-table/README.md
index 045a47a101..945d515e62 100644
--- a/crates/nu-table/README.md
+++ b/crates/nu-table/README.md
@@ -1,3 +1,7 @@
+The layout logic for Nushell's table viewer.
+
+See also the separate `table` command implementation
+
 ## Internal Nushell crate
 
 This crate implements components of Nushell and is not designed to support plugin authors or other users directly.