Apply suggestions from code review

Co-authored-by: Luca Kellermann <[email protected]>

Author: sandwwraith

core/commonMain/src/kotlinx/serialization/descriptors/SerialDescriptor.kt

@@ -270,6 +270,8 @@ public interface SerialDescriptor {
      * @Serializable
      * class Outer(@OnPropertySerialAnnotation val nested: Nested)
      *
+     * val outerDescriptor = Outer.serializer().descriptor
+     *
      * outerDescriptor.getElementAnnotations(0) // Returns [@OnPropertySerialAnnotation]
      * outerDescriptor.getElementDescriptor(0).annotations // Returns [@OnClassSerialAnnotation]
      * ```
@@ -332,6 +334,8 @@ public interface SerialDescriptor {
      * @Serializable
      * class Outer(@OnPropertySerialAnnotation val nested: Nested)
      *
+     * val outerDescriptor = Outer.serializer().descriptor
+     *
      * outerDescriptor.getElementAnnotations(0) // Returns [@OnPropertySerialAnnotation]
      * outerDescriptor.getElementDescriptor(0).annotations // Returns [@OnClassSerialAnnotation]
      * ```