diff --git a/extide/gradle/apichanges.xml b/extide/gradle/apichanges.xml
index db73ba3..f3481b1 100644
--- a/extide/gradle/apichanges.xml
+++ b/extide/gradle/apichanges.xml
@@ -83,6 +83,23 @@
     <!-- ACTUAL CHANGES BEGIN HERE: -->
 
     <changes>
+        <change id="gradle-reports">
+            <api name="general"/>
+            <summary>Rich exception reports are exported from Gradle process.</summary>
+            <version major="2" minor="27"/>
+            <date day="20" month="8" year="2022"/>
+            <author login="sdedic"/>
+            <compatibility semantic="compatible" addition="yes"/>
+            <description>
+                Errors are transferred including their causes and script location(s), so the IDE may provide better messages or hints.
+                <p>
+                    The new class <code>
+                        <a href="@TOP@/org/netbeans/modules/gradle/api/GradleReport.html">GradleReport</a>
+                    </code> that contain this information is available from
+                <code><a href="@TOP@/org/netbeans/modules/gradle/api/GradleBaseProject.html#getProblems">GradleBaseProject.getProblems()</a></code> method.
+                </p>
+            </description>
+        </change>
         <change id="configuration-dependencies">
             <api name="general"/>
             <summary>Allow to inspect dependency tree</summary>
@@ -127,17 +144,6 @@
             </description>
             <class package="org.netbeans.modules.gradle.api" name="NbGradleProject"/>
         </change>
-        <change id="gradle-reports">
-            <api name="general"/>
-            <summary>Rich exception reports are exported from Gradle process.</summary>
-            <version major="2" minor="23"/>
-            <date day="28" month="2" year="2022"/>
-            <author login="sdedic"/>
-            <compatibility semantic="compatible" addition="yes"/>
-            <description>
-                Errors are transferred including their causes and script location(s), so the IDE may provide better messages or hints.
-            </description>
-        </change>
         <change id="gradle-cli-update">
             <api name="general"/>
             <summary>GradleCommandLine Flag, Parameter, and Property implements GradleOptionItem interface</summary>
diff --git a/extide/gradle/src/org/netbeans/modules/gradle/api/GradleBaseProject.java b/extide/gradle/src/org/netbeans/modules/gradle/api/GradleBaseProject.java
index c7277f4..e10de6b 100644
--- a/extide/gradle/src/org/netbeans/modules/gradle/api/GradleBaseProject.java
+++ b/extide/gradle/src/org/netbeans/modules/gradle/api/GradleBaseProject.java
@@ -171,6 +171,15 @@
         return includedBuilds;
     }
 
+    /**
+     * Return the list of problems reported by Gradle on
+     * project inspection. In an ideal case that should be an
+     * empty set.
+     *
+     * @return Gradle reported problems during inspection.
+     * 
+     * @since 2.27
+     */
     public Set<GradleReport> getProblems() {
         return problems;
     }
diff --git a/extide/gradle/src/org/netbeans/modules/gradle/api/GradleReport.java b/extide/gradle/src/org/netbeans/modules/gradle/api/GradleReport.java
index ff19382..d3a587e 100644
--- a/extide/gradle/src/org/netbeans/modules/gradle/api/GradleReport.java
+++ b/extide/gradle/src/org/netbeans/modules/gradle/api/GradleReport.java
@@ -32,8 +32,9 @@
 /**
  * Describes a problem in a buildscript reported by Gradle daemon and/or
  * our infrastructure.
- * 
+ *
  * @author sdedic
+ * @since 2.27
  */
 public final class GradleReport {
     private final String errorClass;