From e00072f32d016c8fa5b51dd3ce93971e29012c62 Mon Sep 17 00:00:00 2001
From: Karol Lewandowski <karol.lewandowski@jetbrains.com>
Date: Wed, 27 Jul 2022 13:04:50 +0200
Subject: [PATCH] add warning about file type factory deprecation and simplify
 registration content in simple language tutorial

---
 .../custom_language_support/registering_file_type.md      | 4 ++++
 .../custom_language_support/language_and_filetype.md      | 8 +++++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/topics/reference_guide/custom_language_support/registering_file_type.md b/topics/reference_guide/custom_language_support/registering_file_type.md
index 57e563e1b..31999c84b 100644
--- a/topics/reference_guide/custom_language_support/registering_file_type.md
+++ b/topics/reference_guide/custom_language_support/registering_file_type.md
@@ -29,6 +29,10 @@ To associate the file type in the IDE, specify one or more associations as liste
 
 <tab title="Pre-2019.2">
 
+> The FileType Factory approach is deprecated. Use it only when the plugin requires support for platform versions older than 2019.2.
+>
+{type="warning"}
+
 To register a file type, the plugin developer provides a subclass of [`FileTypeFactory`](upsource:///platform/ide-core/src/com/intellij/openapi/fileTypes/FileTypeFactory.java), which is registered via the `com.intellij.fileTypeFactory` extension point.
 
 </tab>
diff --git a/topics/tutorials/custom_language_support/language_and_filetype.md b/topics/tutorials/custom_language_support/language_and_filetype.md
index 60cc5e00a..130954b7f 100644
--- a/topics/tutorials/custom_language_support/language_and_filetype.md
+++ b/topics/tutorials/custom_language_support/language_and_filetype.md
@@ -48,9 +48,7 @@ The Simple Language file type is defined by subclassing [`LanguageFileType`](ups
 
 <tab title="2019.2 and later">
 
-Direct registration is possible - no `FileTypeFactory` is required.
-
-Instead, the file type is registered via the `com.intellij.fileType` extension point in <path>plugin.xml</path> and registered with <path>*.simple</path> extension:
+The Simple Language file type is registered via the `com.intellij.fileType` extension point in <path>plugin.xml</path> and registered with <path>*.simple</path> extension:
 
 ```xml
 <extensions defaultExtensionNs="com.intellij">
@@ -67,6 +65,10 @@ Instead, the file type is registered via the `com.intellij.fileType` extension p
 
 <tab title="Pre-2019.2">
 
+> The FileType Factory approach is deprecated. Use it only when the plugin requires support for platform versions older than 2019.2.
+>
+{type="warning"}
+
 ### Define a FileType Factory
 
 First, define `SimpleFileTypeFactory` as a subclass of [`FileTypeFactory`](upsource:///platform/ide-core/src/com/intellij/openapi/fileTypes/FileTypeFactory.java).