diff --git a/reference_guide/api_changes_list_2017.md b/reference_guide/api_changes_list_2017.md
index bd7bea3a3..e5c0c1530 100644
--- a/reference_guide/api_changes_list_2017.md
+++ b/reference_guide/api_changes_list_2017.md
@@ -8,9 +8,9 @@ See the note on how to document new problems on the main page reference_guide/ap
 
 Please see [Incompatible API Changes](api_changes_list.md) on how to verify compatibility.
 
- >  Changes from API marked with `org.jetbrains.annotations.ApiStatus.@Experimental`/`ScheduledForRemoval` are not listed here, as incompatible changes are to be expected.
+ >  Changes from API marked with [`org.jetbrains.annotations.ApiStatus`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java) `@Experimental`, `@ScheduledForRemoval`, or `@Internal` are not listed here, as incompatible changes are to be expected.
  >
- {type="note"}
+ {type="note"} 
 
 ## 2017.3
 
diff --git a/reference_guide/api_changes_list_2018.md b/reference_guide/api_changes_list_2018.md
index 7b9179f52..bab078872 100644
--- a/reference_guide/api_changes_list_2018.md
+++ b/reference_guide/api_changes_list_2018.md
@@ -12,9 +12,9 @@ See the note on how to document new problems on the main page reference_guide/ap
 
 Please see [Incompatible API Changes](api_changes_list.md) on how to verify compatibility.
 
- >  Changes from API marked with `org.jetbrains.annotations.ApiStatus.@Experimental`/`ScheduledForRemoval` are not listed here, as incompatible changes are to be expected.
+ >  Changes from API marked with [`org.jetbrains.annotations.ApiStatus`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java) `@Experimental`, `@ScheduledForRemoval`, or `@Internal` are not listed here, as incompatible changes are to be expected.
  >
- {type="note"}
+ {type="note"} 
 
 ## 2018.3
 
diff --git a/reference_guide/api_changes_list_2019.md b/reference_guide/api_changes_list_2019.md
index bdebd49ad..bb9502dd6 100644
--- a/reference_guide/api_changes_list_2019.md
+++ b/reference_guide/api_changes_list_2019.md
@@ -60,9 +60,9 @@ NOTE: Entries not starting with code quotes (`name`) can be added to document no
 
 Please see [Incompatible API Changes](api_changes_list.md) on how to verify compatibility.
 
- >  Changes from API marked with `org.jetbrains.annotations.ApiStatus.@Experimental`/`ScheduledForRemoval` are not listed here, as incompatible changes are to be expected.
+ >  Changes from API marked with [`org.jetbrains.annotations.ApiStatus`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java) `@Experimental`, `@ScheduledForRemoval`, or `@Internal` are not listed here, as incompatible changes are to be expected.
  >
- {type="note"}
+ {type="note"} 
 
 ## 2019.3
 
diff --git a/reference_guide/api_changes_list_2020.md b/reference_guide/api_changes_list_2020.md
index a21ce82d4..e2cf9f0f5 100644
--- a/reference_guide/api_changes_list_2020.md
+++ b/reference_guide/api_changes_list_2020.md
@@ -60,14 +60,15 @@ NOTE: Entries not starting with code quotes (`name`) can be added to document no
 
 Please see [Incompatible API Changes](api_changes_list.md) on how to verify compatibility.
 
- >  Changes from API marked with `org.jetbrains.annotations.ApiStatus.@Experimental`/`ScheduledForRemoval` are not listed here, as incompatible changes are to be expected.
+ >  Changes from API marked with [`org.jetbrains.annotations.ApiStatus`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java) `@Experimental`, `@ScheduledForRemoval`, or `@Internal` are not listed here, as incompatible changes are to be expected.
  >
- {type="note"}
+ {type="note"} 
 
 ## 2020.3
 
- >  Java 11 is now required ([blog post](https://blog.jetbrains.com/platform/2020/09/intellij-project-migrates-to-java-11/)) when targeting 2020.3 and later only.
->  Please make sure to always upgrade to the latest version of `gradle-intellij-plugin`. Follow releases on [GitHub](https://github.com/JetBrains/gradle-intellij-plugin/releases).
+ >  Java 11 is required ([blog post](https://blog.jetbrains.com/platform/2020/09/intellij-project-migrates-to-java-11/)) when targeting 2020.3 and later only.
+ >  
+ >  Please make sure to always upgrade to the [latest version](https://github.com/JetBrains/gradle-intellij-plugin/releases) of `gradle-intellij-plugin`.
  >
  {type="note"}
 
diff --git a/reference_guide/api_changes_list_2021.md b/reference_guide/api_changes_list_2021.md
index 9790852cc..ffe07a4e3 100644
--- a/reference_guide/api_changes_list_2021.md
+++ b/reference_guide/api_changes_list_2021.md
@@ -59,12 +59,13 @@ NOTE: Entries not starting with code quotes (`name`) can be added to document no
 
 Please see [Incompatible API Changes](api_changes_list.md) on how to verify compatibility.
 
- >  Changes from API marked with `org.jetbrains.annotations.ApiStatus.@Experimental`/`ScheduledForRemoval` are not listed here, as incompatible changes are to be expected.
+ >  Changes from API marked with [`org.jetbrains.annotations.ApiStatus`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java) `@Experimental`, `@ScheduledForRemoval`, or `@Internal` are not listed here, as incompatible changes are to be expected.
  >
  {type="note"}
        
  >  Java 11 is required ([blog post](https://blog.jetbrains.com/platform/2020/09/intellij-project-migrates-to-java-11/)) when targeting 2020.3 and later only.
- >  Please make sure to always upgrade to the latest version of `gradle-intellij-plugin`. Follow releases on [GitHub](https://github.com/JetBrains/gradle-intellij-plugin/releases).
+ >  
+ >  Please make sure to always upgrade to the [latest version](https://github.com/JetBrains/gradle-intellij-plugin/releases) of `gradle-intellij-plugin`.
  >
  {type="note"}