From 4b277ec41f78128ae054fd76921b5f6d85b6ec25 Mon Sep 17 00:00:00 2001
From: Karol Lewandowski <karol.lewandowski@jetbrains.com>
Date: Thu, 24 Apr 2025 15:58:12 +0200
Subject: [PATCH] Rename project wizard pages and group into sections

---
 ijs.tree                                          | 15 +++++++++------
 ...project_wizard.md => legacy_project_wizard.md} |  4 +++-
 topics/reference_guide/new_project_wizard.md      |  2 +-
 topics/reference_guide/project_wizards_intro.md   |  9 +++++++++
 4 files changed, 22 insertions(+), 8 deletions(-)
 rename topics/reference_guide/{project_wizard.md => legacy_project_wizard.md} (98%)
 create mode 100644 topics/reference_guide/project_wizards_intro.md

diff --git a/ijs.tree b/ijs.tree
index 234d5b891..ce7b598cf 100644
--- a/ijs.tree
+++ b/ijs.tree
@@ -149,13 +149,16 @@
     <toc-element topic="project_model.md" accepts-web-file-names="project-structure.html">
       <toc-element topic="project.md">
         <toc-element topic="trusted_projects.md"/>
-        <toc-element topic="new_project_wizard.md"/>
-        <toc-element topic="project_wizard.md"/>
-        <toc-element topic="intro_project_wizard.md" accepts-web-file-names="project_wizard.html">
-          <toc-element topic="adding_new_steps.md"/>
-          <toc-element topic="module_types.md"/>
+        <toc-element topic="project_wizards_intro.md">
+          <toc-element topic="new_project_wizard.md"/>
+          <toc-element topic="legacy_project_wizard.md">
+            <toc-element topic="intro_project_wizard.md" accepts-web-file-names="project_wizard.html,project-wizard.html">
+              <toc-element topic="adding_new_steps.md"/>
+              <toc-element topic="module_types.md"/>
+            </toc-element>
+            <toc-element topic="framework.md"/>
+          </toc-element>
         </toc-element>
-        <toc-element topic="framework.md"/>
       </toc-element>
       <toc-element topic="module.md"/>
       <toc-element topic="sdk.md"/>
diff --git a/topics/reference_guide/project_wizard.md b/topics/reference_guide/legacy_project_wizard.md
similarity index 98%
rename from topics/reference_guide/project_wizard.md
rename to topics/reference_guide/legacy_project_wizard.md
index b666fba37..76775eec5 100644
--- a/topics/reference_guide/project_wizard.md
+++ b/topics/reference_guide/legacy_project_wizard.md
@@ -1,9 +1,11 @@
 <!-- Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
-# Project Wizard - Adding Support for Creating New Project Types
+# Legacy Project Wizard API
 
 <link-summary>Implementing a custom project creation wizard.</link-summary>
 
+> Plugins targetting versions 2024.2 and newer should implement [](new_project_wizard.md).
+
 ## Project Wizard
 
 Working with the project wizard can be illustrated with the [RedLine SmallTalk plugin](https://github.com/bulenkov/RedlineSmalltalk). See also [](intro_project_wizard.md).
diff --git a/topics/reference_guide/new_project_wizard.md b/topics/reference_guide/new_project_wizard.md
index 018641134..1ab176a9e 100644
--- a/topics/reference_guide/new_project_wizard.md
+++ b/topics/reference_guide/new_project_wizard.md
@@ -1,6 +1,6 @@
 <!-- Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
-# New Project Wizard
+# New Project Wizard API
 <primary-label ref="2024.2"/>
 
 <link-summary>Implementing a custom project and module creation wizard.</link-summary>
diff --git a/topics/reference_guide/project_wizards_intro.md b/topics/reference_guide/project_wizards_intro.md
new file mode 100644
index 000000000..39d0dd236
--- /dev/null
+++ b/topics/reference_guide/project_wizards_intro.md
@@ -0,0 +1,9 @@
+<!-- Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
+
+# Project Wizards
+
+Creating a project in IntelliJ-based IDEs is achieved with [project wizards](https://www.jetbrains.com/help/idea/new-project-wizard.html) gathering information about the created project and generating it.
+
+IntelliJ Platform provides APIs to implement wizards:
+- [](new_project_wizard.md) — available since 2024.2
+- [](legacy_project_wizard.md) — an old API, not recommended to implement in plugins targeting versions 2024.2 and newer