diff --git a/docs/analysis-api/analysis-api-fe10.md b/docs/analysis/analysis-api/analysis-api-fe10.md
similarity index 100%
rename from docs/analysis-api/analysis-api-fe10.md
rename to docs/analysis/analysis-api/analysis-api-fe10.md
diff --git a/docs/analysis-api/analysis-api-fir.md b/docs/analysis/analysis-api/analysis-api-fir.md
similarity index 63%
rename from docs/analysis-api/analysis-api-fir.md
rename to docs/analysis/analysis-api/analysis-api-fir.md
index a052423a2fd..5026bd92cf2 100644
--- a/docs/analysis-api/analysis-api-fir.md
+++ b/docs/analysis/analysis-api/analysis-api-fir.md
@@ -1,4 +1,4 @@
 # Analysis API FIR Implementation
-To work with FIR compiler, FIR Analysis API Implementation uses [Low-Level API](low-level-api-fir.md)
+To work with FIR compiler, FIR Analysis API Implementation uses [Low-Level API](../low-level-api-fir/low-level-api-fir.md)
 
 TODO
\ No newline at end of file
diff --git a/docs/analysis-api/analysis-api.md b/docs/analysis/analysis-api/analysis-api.md
similarity index 95%
rename from docs/analysis-api/analysis-api.md
rename to docs/analysis/analysis-api/analysis-api.md
index a0958ff49e5..b75c855a47e 100644
--- a/docs/analysis-api/analysis-api.md
+++ b/docs/analysis/analysis-api/analysis-api.md
@@ -13,11 +13,11 @@ currently available.
 
 * FIR-based implementation. FIR is a new compiler frontend which is a part of K2 Kotlin compiler. Read more:
     * [Analysis API FIR Implementation documentation](analysis-api-fir.md)
-    * [Analysis API FIR Implementation source code](../../analysis/analysis-api-fir)
-    * [FIR Compiler documentation](../fir/fir-basics.md)
+    * [Analysis API FIR Implementation source code](../../../analysis/analysis-api-fir)
+    * [FIR Compiler documentation](../../fir/fir-basics.md)
 * FE1.0-based implementation. FE1.0 is an original Kotlin compiler frontend. Read more:
     * [Analysis API FE1.0 Implementation documentation](analysis-api-fe10.md)
-    * [Analysis API FE1.0 Implementation source code](../../analysis/analysis-api-fe10)
+    * [Analysis API FE1.0 Implementation source code](../../../analysis/analysis-api-fe10)
 
 Analysis API can work outside IntelliJ IDEA (e.g, it can be used for implementing Kotlin LSP server) but it still uses some basic classes
 form IntelliJ Core. This is needed mostly for working with [PsiElements](https://plugins.jetbrains.com/docs/intellij/psi-elements.html),
diff --git a/docs/analysis-api/development-process/code-style.md b/docs/analysis/development-process/code-style.md
similarity index 100%
rename from docs/analysis-api/development-process/code-style.md
rename to docs/analysis/development-process/code-style.md
diff --git a/docs/analysis-api/development-process/contributing-guidelines.md b/docs/analysis/development-process/contributing-guidelines.md
similarity index 100%
rename from docs/analysis-api/development-process/contributing-guidelines.md
rename to docs/analysis/development-process/contributing-guidelines.md
diff --git a/docs/analysis-api/development-process/development-process.md b/docs/analysis/development-process/development-process.md
similarity index 100%
rename from docs/analysis-api/development-process/development-process.md
rename to docs/analysis/development-process/development-process.md
diff --git a/docs/analysis-api/low-level-api-fir.md b/docs/analysis/low-level-api-fir/low-level-api-fir.md
similarity index 100%
rename from docs/analysis-api/low-level-api-fir.md
rename to docs/analysis/low-level-api-fir/low-level-api-fir.md