diff --git a/language/oop5/properties.xml b/language/oop5/properties.xml
index 2516f3942e7a..80781b754b3e 100644
--- a/language/oop5/properties.xml
+++ b/language/oop5/properties.xml
@@ -334,16 +334,12 @@ $test->obj = new stdClass;
     This dynamically created property will <emphasis>only</emphasis> be
     available on this class instance.
    </para>
-
+   <para>
+    Dynamic properties are supported by <link linkend="stdclass.intro">stdClass</link> and its subclasses. Other classes may enable similar behavior with <link linkend="allowdynamicproperties.intro">AllowDynamicProperties</link> or <link linkend="language.oop5.overloading">property overloading</link>.
+   </para>
    <warning>
     <simpara>
-     Dynamic properties are deprecated as of PHP 8.2.0.
-     It is recommended to declare the property instead.
-     To handle arbitrary property names, the class should implement the magic
-     methods <link linkend="object.get">__get()</link> and
-     <link linkend="object.set">__set()</link>.
-     At last resort the class can be marked with the
-     <code>#[\AllowDynamicProperties]</code> attribute.
+     Prior to PHP 8.2.0, <emphasis>all</emphasis> classes supported dynamic properties. This is deprecated. By default, accessing an undeclared property will emit a deprecation warning.
     </simpara>
    </warning>
   </sect2>
diff --git a/language/predefined/attributes/allowdynamicproperties.xml b/language/predefined/attributes/allowdynamicproperties.xml
index 7cefa2d8a384..584c0f60427d 100644
--- a/language/predefined/attributes/allowdynamicproperties.xml
+++ b/language/predefined/attributes/allowdynamicproperties.xml
@@ -11,6 +11,12 @@
     This attribute is used to mark classes that allow
     <link linkend="language.oop5.properties.dynamic-properties">dynamic properties</link>.
    </para>
+   <note>
+     <para>
+       Prior to PHP 8.2.0, all classes implicitly allowed dynamic properties.
+       Implicit creation of dynamic properties is now deprecated.
+     </para>
+   </note>
   </section>
 
   <section xml:id="allowdynamicproperties.synopsis">
@@ -38,32 +44,43 @@
 
   <section>
    &reftitle.examples;
-   <para>
-    Dynamic properties are deprecated as of PHP 8.2.0,
-    thus using them without marking the class with this attribute will emit
-    a deprecation notice.
-   </para>
    <example>
+    <para>
+     To enable dynamic properties, add <literal>#[\AllowDynamicProperties]</literal>.
+    </para>
     <programlisting role="php">
 <![CDATA[
 <?php
-class DefaultBehaviour { }
-
 #[\AllowDynamicProperties]
-class ClassAllowsDynamicProperties { }
+class ValidExample { }
 
-$o1 = new DefaultBehaviour();
-$o2 = new ClassAllowsDynamicProperties();
+$obj = new ValidExample();
+$obj->myDynamicProp = 1234;
+?>
+]]>
+    </programlisting>
+   </example>
+
+   <example>
+    <para>
+     As of PHP 8.2.0, the declaration is required. If the declaration is omitted
+     and an undeclared property is accessed, PHP will raise a warning.
+    </para>
+
+    <programlisting role="php">
+<![CDATA[
+<?php
+class InvalidExample { }
 
-$o1->nonExistingProp = true;
-$o2->nonExistingProp = true;
+$obj = new InvalidExample();
+$obj->myUnknownProperty = 1234;
 ?>
 ]]>
     </programlisting>
     &example.outputs.82;
     <screen>
 <![CDATA[
-Deprecated: Creation of dynamic property DefaultBehaviour::$nonExistingProp is deprecated in file on line 10
+Deprecated: Creation of dynamic property InvalidExample::$myUnknownProperty is deprecated in file on line 5
 ]]>
     </screen>
    </example>