diff --git a/build.gradle.kts b/build.gradle.kts
index 61db96bee..e886f7a74 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -1,5 +1,4 @@
 import com.adarshr.gradle.testlogger.theme.ThemeType
-import org.jetbrains.changelog.markdownToHTML
 import org.jetbrains.intellij.tasks.RunPluginVerifierTask.VerificationReportsFormats.*
 import org.jetbrains.intellij.tasks.RunPluginVerifierTask.FailureLevel.*
 
@@ -51,12 +50,11 @@ sourceSets {
 // Dependencies are managed with Gradle version catalog - read more: https://docs.gradle.org/current/userguide/platforms.html#sub:version-catalog
 dependencies {
     implementation("org.zeroturnaround:zt-zip:1.14")
-    implementation("com.kotcrab.remark:remark:1.2.0")
-    implementation("org.jsoup:jsoup:1.14.2")
+    implementation("org.jsoup:jsoup:1.17.1")
     implementation("org.eclipse.lsp4j:org.eclipse.lsp4j:$lsp4jVersion")
     // Required by lsp4j as the version from IJ is incompatible
-    implementation("com.google.code.gson:gson:2.8.9")
-    implementation("com.vladsch.flexmark:flexmark:0.62.2")
+    implementation("com.google.code.gson:gson:2.10.1")
+    implementation("com.vladsch.flexmark:flexmark:0.64.8")
 
     testImplementation("com.redhat.devtools.intellij:intellij-common-ui-test-library:0.2.0")
     testImplementation("org.assertj:assertj-core:3.19.0")
@@ -151,20 +149,6 @@ tasks {
         version = properties("pluginVersion")
         sinceBuild = properties("pluginSinceBuild")
         untilBuild = properties("pluginUntilBuild")
-
-        // Extract the <!-- Plugin description --> section from README.md and provide for the plugin's manifest
-        pluginDescription = providers.fileContents(layout.projectDirectory.file("README.md")).asText.map {
-            val start = "<!-- Plugin description -->"
-            val end = "<!-- Plugin description end -->"
-
-            with(it.lines()) {
-                if (!containsAll(listOf(start, end))) {
-                    throw GradleException("Plugin description section not found in README.md:\n$start ... $end")
-                }
-                subList(indexOf(start) + 1, indexOf(end)).joinToString("\n").let(::markdownToHTML)
-            }
-        }
-
         //TODO inject changelog into plugin.xml change-notes
     }
 
diff --git a/src/main/resources/META-INF/plugin.xml b/src/main/resources/META-INF/plugin.xml
index 39a7e5c07..a82acd686 100644
--- a/src/main/resources/META-INF/plugin.xml
+++ b/src/main/resources/META-INF/plugin.xml
@@ -10,12 +10,32 @@
       <li>Initial release</li>
     </ul>    
     Learn more in the <a href="https://github.com/redhat-developer/lsp4ij/milestone/1?closed=1">changelog</a>.
+  ]]>
+  </change-notes>
+  <description>
+    <![CDATA[
+    <p>LSP4IJ is a free and open-source <a href="https://microsoft.github.io/language-server-protocol/">Language Server protocol (LSP)</a> client compatible with all flavors of IntelliJ.</p>
+
+    <p>It currently doesn't provide any useful functionality on its own but is instead used as a dependency for other extensions, willing to integrate language servers with IntelliJ products.</p>
+
+    <h3>LSP4IJ provides:</h3>
+    <ul>
+        <li>Language server <code>extension points</code> to add any language server:
+            <ul>
+                <li><code>com.redhat.devtools.lsp4ij.server</code> extension point to define a language server.</li>
+                <li><code>com.redhat.devtools.lsp4ij.languageMapping</code> to associate an IntelliJ language with a language server definition.</li>
+            </ul>
+        </li>
+        <li>An <code>LSP Consoles view</code> to track LSP requests, responses, and notifications in a console.</li>
+        <li>A <code>Language Servers settings page</code> to configure the LSP trace level and the debug port to use to debug the language server.</li>
+    </ul>
     ]]>
-    </change-notes>
-    <depends>com.intellij.modules.platform</depends>
-    <!-- FIXME we shouldn't have a dependency to Java, this is caused by using 'LightRecordField' (e.g. in LSPIJUtils.getNavigationElement(PsiElement)) -->
-    <depends>com.intellij.modules.java</depends>
-    <depends>com.redhat.devtools.intellij.telemetry</depends>
+  </description>
+
+  <depends>com.intellij.modules.platform</depends>
+  <!-- FIXME we shouldn't have a dependency to Java, this is caused by using 'LightRecordField' (e.g. in LSPIJUtils.getNavigationElement(PsiElement)) -->
+  <depends>com.intellij.modules.java</depends>
+  <depends>com.redhat.devtools.intellij.telemetry</depends>
 
 
     <!-- please see http://www.jetbrains.org/intellij/sdk/docs/basics/getting_started/build_number_ranges.html for description -->