From b643727c54328a5542321405c8a140f4ef513a6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20C=C3=A9bron?= <yann.cebron@jetbrains.com>
Date: Thu, 10 Mar 2022 17:48:11 +0100
Subject: [PATCH] code_samples.md: some clarifications, edits

---
 topics/intro/code_samples.md | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/topics/intro/code_samples.md b/topics/intro/code_samples.md
index 9eb5e525f..7632eebab 100644
--- a/topics/intro/code_samples.md
+++ b/topics/intro/code_samples.md
@@ -2,32 +2,36 @@
 
 <!-- Copyright 2000-2022 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
 
-## Introduction
-
 This guide comes with a number of sample plugins available from dedicated [intellij-sdk-code-samples](https://github.com/JetBrains/intellij-sdk-code-samples) GitHub repository.
 
 Please see <path>README.md</path> which lists all available code samples with a short description.
 
-Each sample is stored in a dedicated folder and is accompanied by its own <path>README.md</path>. Links to the corresponding tutorial or reference page in this tutorial, as well as a list of relevant show-cased elements are provided.
+Each sample is stored in a dedicated folder and is accompanied by its own <path>README.md</path>.
+Links to the corresponding tutorial or reference page in this tutorial, as well as a list of relevant show-cased elements are provided.
 
 ## Using Gradle
 
 All sample plugins are based on Gradle, see [Building Plugins with Gradle](gradle_build_system.md) to get started.
 
-Additionally, the screencast [Working with Gradle in IntelliJ IDEA](https://www.youtube.com/watch?v=6V6G3RyxEMk) offers a thorough introduction to Gradle functionality inside IntelliJ IDEA.
+Additionally, the screencast *Working with Gradle in IntelliJ IDEA* offers a thorough introduction to Gradle functionality inside IntelliJ IDEA.
+
+<video href="6V6G3RyxEMk" title="Working with Gradle in IntelliJ IDEA" width="300"/>
 
 ## Setting up Code Samples
 
 Make sure plugins _Git_, _Gradle_, and _Plugin DevKit_ are enabled.
 
-Clone the [intellij-sdk-code-samples](https://github.com/JetBrains/intellij-sdk-code-samples) GitHub repository via <control>Git | Clone...</control>. After successful cloning, the IDE suggests opening the project.
+Clone the [intellij-sdk-code-samples](https://github.com/JetBrains/intellij-sdk-code-samples) GitHub repository via <control>Git | Clone...</control>.
+After successful cloning, the IDE suggests opening the project.
 
 Select the code sample(s) to import via the [Gradle tool window](https://www.jetbrains.com/help/idea/gradle.html#link_gradle_project).
 
-Alternatively, import _all_ code samples available by choosing `_gradleCompositeBuild`, which links all Gradle projects in a Composite Build.
+Alternatively, import _all_ code samples available by choosing <path>_gradleCompositeBuild</path>, which links all Gradle projects in a Composite Build.
 
-After successful import, the project appears in the Gradle tool window tree as a new node.
+After successful import, the project appears in the <control>Gradle</control> tool window tree as a new node.
+Assign a Java 11 SDK in <menupath>Preferences | Build, Execution, Deployment | Build Tools | Gradle</menupath> for <control>Gradle JVM</control>.
+Invoke <control>Reload All Gradle Projects</control> from the Gradle tool window toolbar if necessary.
 
 ## Running Code Samples
 
-Run the plugin by using the Gradle [runIde task](gradle_prerequisites.md#executing-the-plugin) shown under the corresponding project's <control>Tasks</control> node.
+Run the plugin by using the Gradle [runIde task](gradle_prerequisites.md#executing-the-plugin) shown under the corresponding project's <control>Tasks</control> node in the <control>Gradle</control> tool window.