diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-resources.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-resources.mdx
new file mode 100644
index 000000000..be1d2caa7
--- /dev/null
+++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-resources.mdx
@@ -0,0 +1,26 @@
+---
+title: aspire resources command
+description: Learn about the aspire resources command alias and migrate to the primary aspire describe command.
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+## Name
+
+`aspire resources` - Alias for `aspire describe`.
+
+## Description
+
+<Aside type="caution" title="Command renamed">
+  `aspire resources` is a backward-compatible alias. Use
+  [`aspire describe`](/reference/cli/commands/aspire-describe/) as the
+  primary command name.
+</Aside>
+
+The `aspire resources` command was renamed to `aspire describe`. Existing scripts that use `aspire resources` continue to work.
+
+The `--watch` flag was also renamed to `--follow` (`-f`). Use `aspire describe --follow` for continuous updates.
+
+## See also
+
+- [aspire describe command](/reference/cli/commands/aspire-describe/)