From e92188df1cc22b2c40b82558ebdf16af2b16446c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20C=C3=A9bron?= <yann.cebron@jetbrains.com>
Date: Mon, 21 Sep 2020 14:28:36 +0200
Subject: [PATCH] API Changes pages: update comments

---
 .../api_changes/api_changes_list_2019.md      | 55 +------------------
 .../api_changes/api_changes_list_2020.md      |  2 +-
 reference_guide/api_changes_list.md           |  2 +-
 3 files changed, 3 insertions(+), 56 deletions(-)

diff --git a/reference_guide/api_changes/api_changes_list_2019.md b/reference_guide/api_changes/api_changes_list_2019.md
index 6cf25c92b..7ab292867 100644
--- a/reference_guide/api_changes/api_changes_list_2019.md
+++ b/reference_guide/api_changes/api_changes_list_2019.md
@@ -4,60 +4,7 @@ title: Incompatible Changes in IntelliJ Platform and Plugins API 2019.*
 <!-- Copyright 2000-2020 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
 
 <!--
-Before documenting a breaking API change, please, make sure that the change cannot be avoided 
-in an alternative way.
-
-APIs marked with @ApiStatus.Experimental, @ApiStatus.Internal or @ApiStatus.ScheduledForRemoval don't need to be documented.
-
-To document a new incompatible change, add a new line with the problem pattern
-followed by a 2nd line with ": "-prefixed human-readable description and recommended fix/action.
-
-The following problem patterns are supported:
-
-<package name> package removed
-<class name> class removed
-<class name> class renamed to <new class name>
-
-<class name>.<method name>(<human-readable parameters>) method removed
-<class name>.<method name>(<human-readable parameters>) method return type changed from <before> to <after>
-<class name>.<method name>(<human-readable parameters>) method parameter <type> removed
-<class name>.<method name>(<human-readable parameters>) method parameter type changed from <before> to <after>
-<class name>.<method name>(<human-readable parameters>) method visibility changed from <before> to <after>
-<class name>.<method name>(<human-readable parameters>) method marked final
-<class name> (class|interface) now (extends|implements) <class name> and inherits its final method <method name>(<human-readable parameters>)?
-<class name> (class|interface) now (extends|implements) <class name> and inherits its abstract method <method name>(<human-readable parameters>)?
-<class name>.<method name> method <parameter name> parameter marked @<class name>
-
-<class name>(<human-readable parameters>) constructor removed
-<class name>(<human-readable parameters>) constructor parameter <type> removed
-<class name>(<human-readable parameters>) constructor parameter type changed from <before> to <after>
-<class name>(<human-readable parameters>) constructor visibility changed from <before> to <after>
-
-<class name>.<field name> field removed
-<class name>.<field name> field type changed from <before> to <after>
-<class name>.<field name> field visibility changed from <before> to <after>
-
-<class name>.<method name>(<human-readable parameters>) marked abstract
-<class name>.<method name>(<human-readable parameters>) abstract method added
-<class name> class moved to package <package name>
-
-<property name> property removed from resource bundle <bundle name>
-
-where the placeholders must be enclosed in code quotes (`name`):
-
-<class name> is a fully-qualified name of the class, e.g. `com.intellij.openapi.actionSystem.AnAction$InnerClass`.
-<method name> is the exact method's name. Note that constructors have dedicated patterns.
-<human-readable parameters> is a string representing parameters, which are not necessarily fully qualified. They do not affect the parser. For example, instead of (java.lang.Object, java.util.List, int) you are free to write (Object, List<String>, int)
-<parameter name> is exact name of the method's parameter
-<property name> is a full name of a property from .properties file, like `some.action.description`
-<bundle name> is a fully qualified name of the property bundle, which includes its package, like `message.IdeBundle`
-
-NOTE: If a code change you're trying to document doesn't match any of the above patterns, fill in a ticket in the YouTrack. 
-An example of a ticket is https://youtrack.jetbrains.com/issue/PR-1218. Until supported, you may document the change as you prefer, and I will correct it later.
-
-NOTE: You are allowed to prettify the pattern using links: [`org.example.Foo`](https://github.com/JetBrains/intellij-community/tree/master/)
-
-NOTE: Entries not starting with code quotes (`name`) can be added to document non-code changes and will be skipped in API verification.
+See the note on how to document new problems on the main page reference_guide/api_changes_list.md 
 -->
 
 Please see [Incompatible API Changes](/reference_guide/api_changes_list.md) on how to verify compatibility.
diff --git a/reference_guide/api_changes/api_changes_list_2020.md b/reference_guide/api_changes/api_changes_list_2020.md
index 06a486add..b62fd5fce 100644
--- a/reference_guide/api_changes/api_changes_list_2020.md
+++ b/reference_guide/api_changes/api_changes_list_2020.md
@@ -53,7 +53,7 @@ where the placeholders must be enclosed in code quotes (`name`):
 <bundle name> is a fully qualified name of the property bundle, which includes its package, like `message.IdeBundle`
 
 NOTE: If a code change you're trying to document doesn't match any of the above patterns, fill in a ticket in the YouTrack. 
-An example of a ticket is https://youtrack.jetbrains.com/issue/PR-1218. Until supported, you may document the change as you prefer, and I will correct it later.
+An example of a ticket is https://youtrack.jetbrains.com/issue/MP-1218. Until supported, you may document the change as you prefer, and I will correct it later.
 
 NOTE: You are allowed to prettify the pattern using links: [`org.example.Foo`](https://github.com/JetBrains/intellij-community/tree/master/)
 
diff --git a/reference_guide/api_changes_list.md b/reference_guide/api_changes_list.md
index 78dfa60cc..919eaefdb 100644
--- a/reference_guide/api_changes_list.md
+++ b/reference_guide/api_changes_list.md
@@ -55,7 +55,7 @@ where the placeholders must be enclosed in code quotes (`name`):
 <bundle name> is a fully qualified name of the property bundle, which includes its package, like `message.IdeBundle`
 
 NOTE: If a code change you're trying to document doesn't match any of the above patterns, fill in a ticket in the YouTrack. 
-An example of a ticket is https://youtrack.jetbrains.com/issue/PR-1218. Until supported, you may document the change as you prefer, and I will correct it later.
+An example of a ticket is https://youtrack.jetbrains.com/issue/MP-1218. Until supported, you may document the change as you prefer, and I will correct it later.
 
 NOTE: You are allowed to prettify the pattern using links: [`org.example.Foo`](https://github.com/JetBrains/intellij-community/tree/master/)