diff --git a/reference_guide/custom_language_support/code_inspections_and_intentions.md b/reference_guide/custom_language_support/code_inspections_and_intentions.md
index 059e052f9..f403de8a6 100644
--- a/reference_guide/custom_language_support/code_inspections_and_intentions.md
+++ b/reference_guide/custom_language_support/code_inspections_and_intentions.md
@@ -12,7 +12,7 @@ class.
 The functionality of
 [`LocalInspectionTool`](upsource:///platform/analysis-api/src/com/intellij/codeInspection/LocalInspectionTool.java)
 partially duplicates that of
-[Annotator](./syntax_highlighting_and_error_highlighting.md#annotator).
+[Annotator](syntax_highlighting_and_error_highlighting.md#annotator).
 
 The main differences are:
 - supports batch analysis of code (through the **Analyze \| Inspect Code...** action)
@@ -20,14 +20,12 @@ The main differences are:
 - ability to configure the inspection options.
 
 If none of that is required and the analysis only needs to run in the active editor,
-[Annotator](./syntax_highlighting_and_error_highlighting.md#annotator)
+[Annotator](syntax_highlighting_and_error_highlighting.md#annotator)
 provides better performance (because of its support for incremental analysis) and more flexibility for highlighting errors.
 
-**Example**:
-A
-[simple inspection](upsource:///plugins/properties/properties-psi-impl/src/com/intellij/codeInspection/TrailingSpacesInPropertyInspection.java)
-for
-[Properties language plugin](upsource:///plugins/properties/)
+**Examples**:
+- [Code Inspections Tutorial](/tutorials/code_inspections.md)
+- A [simple inspection](upsource:///plugins/properties/properties-psi-impl/src/com/intellij/codeInspection/TrailingSpacesInPropertyInspection.java) for [Properties language plugin](upsource:///plugins/properties/)
 
 
 ### Intentions
@@ -38,5 +36,6 @@ The intention classes need to implement the
 interface and are registered using the `com.intellij.intentionAction` extension point in `plugin.xml`.
 
 **Examples:**
+- [Code Intentions Tutorial](/tutorials/code_intentions.md)
 - A [simple intention action](upsource:///plugins/groovy/src/org/jetbrains/plugins/groovy/intentions/control/SplitIfIntention.java) for Groovy
 - [Custom Language Support Tutorial: Quick Fix](/tutorials/custom_language_support/quick_fix.md)