diff --git a/packages/astro-parser/README.md b/packages/astro-parser/README.md
index 3646d53ed..7223de1cf 100644
--- a/packages/astro-parser/README.md
+++ b/packages/astro-parser/README.md
@@ -1,3 +1,5 @@
-# `astro/parser`
+# `@astrojs/parser`
+
+> ⚠️ **Notice** `@astrojs/parser` has been deprecated. In previous versions of `astro` it was responsible for parsing `.astro` files. `astro` has since adopted the brand new [`@astrojs/compiler`](https://github.com/withastro/compiler).
 
 This directory is a fork of `svelte/compiler`. It is meant to stay as close to the original source as possible, so that upstream changes are easy to integrate. Everything svelte-specific and unrelated to parsing (compiler, preprocess, etc) has been removed.