diff --git a/doc/Language/intro.pod6 b/doc/Language/intro.pod6
index 279d2210b..da9fc50c3 100644
--- a/doc/Language/intro.pod6
+++ b/doc/Language/intro.pod6
@@ -9,6 +9,20 @@ goals, such as being brief whilst being comprehensive, catering to professional
 developers with wide experience whilst also being accessible to newcomers to the
 language.
 
+Note the recent name change to Raku from Perl 6 has resulted in some objects
+having changed names and their former names, while still available, are
+deprecated and their use is not recommended in new code. Those items
+are shown in the following table:
+
+=begin table :caption<Raku object names versus deprecated Perl 6 names>
+Raku | Perl 6 | Notes
+=====+========+======
+raku | perl   | routine
+*RAKULIB | PERL6LIB | environment variable for module paths (*NYI)
+.raku | .p6 | file extension for Raku scripts
+.rakumod | .pm6 | file extension for Raku modules
+=end table
+
 For a quick hands-on introduction, there is a short
 L<C<annotated programming example>|/language/101-basics>.