Merge branch '2.16'

.github/workflows/main.yml

@@ -30,7 +30,7 @@ jobs:
     env:
       JAVA_OPTS: "-XX:+TieredCompilation -XX:TieredStopAtLevel=1"
     steps:
-    - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4.1.0
+    - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
     - name: Set up JDK
       uses: actions/setup-java@0ab4596768b603586c0de567f2430c30f5b0d2b0 # v3.13.0
       with:

src/main/java/com/fasterxml/jackson/annotation/JsonProperty.java

@@ -99,6 +99,14 @@ public enum MyEnum {
      * State of this property is exposed via introspection, and its
      * value is typically used by Schema generators, such as one for
      * JSON Schema.
+     *<p>
+     * Also note that the required value must come <b>directly</b> from the
+     * input source (e.g., JSON) and not from secondary sources, such as
+     * defaulting logic or absent value providers.
+     * If secondary sources are expected to supply the value,
+     * this property should be set to {@code false}. This is important because
+     * validation of {@code required} properties occurs before the application of
+     * secondary sources.
      */
     boolean required() default false;