diff --git a/topics/reference_guide/settings_groups.md b/topics/reference_guide/settings_groups.md
index 3b2efcbf7..89d58b7f6 100644
--- a/topics/reference_guide/settings_groups.md
+++ b/topics/reference_guide/settings_groups.md
@@ -1,8 +1,10 @@
-[//]: # (title: Custom Settings Groups)
+# Custom Settings Groups
-As described in [Extension Points for Settings](settings_guide.md#extension-points-for-settings), custom _Settings_ can be declared as children of existing parent groups such as `tools`.
+Defining groups of related settings.
+
+As described in [](settings_guide.md#extension-points-for-settings), custom Settings can be declared as children of existing parent groups such as Tools.
These parent groups are the existing categories of Settings in the IntelliJ Platform-based IDE.
However, suppose the custom Settings are rich enough to require multiple levels?
@@ -60,7 +62,7 @@ This approach nests the child's Settings declaration within the `com.intellij.pr
When using `configurable` there isn't a `parentId` for the child because the nesting implies it.
As with using separate EP declarations, formatting restrictions are placed on the child's `id` attribute - the suffix (`servers`) gets added.
-See the [Attributes for Parent-Child Settings EPs](#attributes-for-parent-child-settings-eps) section.
+See the [](#attributes-for-parent-child-settings-eps) section.
The example below demonstrates a nested `configurable` declaration:
@@ -86,7 +88,7 @@ Within the parent `` EP declaration above, more ` All children share the parent's `id` as the basis of their own `id`.
> All children have an `id` suffix that is unique among their siblings.
->
## Implementations for Parent-Child Settings
Implementations can be based on [`Configurable`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/options/Configurable.java), [`ConfigurableProvider`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/options/ConfigurableProvider.java) or one of their subtypes.
-For more information about creating Settings implementations, see [Implementations for Settings Extension Points](settings_guide.md#implementations-for-settings-extension-points).
+For more information about creating Settings implementations, see [](settings_guide.md#implementations-for-settings-extension-points).
### Configurable Marker Interfaces
diff --git a/topics/tutorials/settings_tutorial.md b/topics/tutorials/settings_tutorial.md
index b17ad8d9c..23b1f694e 100644
--- a/topics/tutorials/settings_tutorial.md
+++ b/topics/tutorials/settings_tutorial.md
@@ -2,7 +2,7 @@
-## Introduction
+Implementing custom settings tutorial.
As discussed in the [](settings_guide.md), plugins can add Settings to IntelliJ Platform-based IDEs.
The IDE displays the Settings in response to a user choosing Settings/Preferences.