diff --git a/maven-plugin-api/src/main/mdo/plugin.mdo b/maven-plugin-api/src/main/mdo/plugin.mdo
index 53faee72ebd0..a172b1bc7057 100644
--- a/maven-plugin-api/src/main/mdo/plugin.mdo
+++ b/maven-plugin-api/src/main/mdo/plugin.mdo
@@ -75,20 +75,20 @@ under the License.
         <field>
           <name>goalPrefix</name>
           <version>1.0.0</version>
-          <description></description>
+          <description>The prefix for the plugin's goal names as used on the command line (e.g. {@code compiler} for {@code compiler:compile}).</description>
           <type>String</type>
         </field>
         <field>
           <name>isolatedRealm</name>
           <version>1.0.0</version>
-          <description></description>
+          <description>If set to {@code true}, the plugin will be loaded in isolation; it will not share the class loader with other plugins. Defaults to {@code false}.</description>
           <type>boolean</type>
           <defaultValue>false</defaultValue>
         </field>
         <field>
           <name>inheritedByDefault</name>
           <version>1.0.0</version>
-          <description></description>
+          <description>If set to {@code true}, Mojos in this plugin are inherited by child projects by default. Defaults to {@code true}.</description>
           <type>boolean</type>
           <defaultValue>true</defaultValue>
         </field>
@@ -188,7 +188,7 @@ under the License.
           <name>executeLifecycle</name>
           <version>1.0.0</version>
           <type>String</type>
-          <description></description>
+          <description>Specifies the name of a custom lifecycle to execute when this Mojo is forking execution (used together with {@code executePhase}).</description>
         </field>
         <field>
           <name>requiresDependencyResolution</name>
@@ -316,12 +316,12 @@ under the License.
           <name>composer</name>
           <version>1.0.0</version>
           <type>String</type>
-          <description></description>
+          <description>The composer type for this Mojo, used to compose the Mojo instance. Normally deduced from the implementation language.</description>
         </field>
         <field xdoc.separator="blank">
           <name>parameters</name>
           <version>1.0.0</version>
-          <description></description>
+          <description>The list of parameters that can be used to configure this Mojo.</description>
           <association>
             <type>Parameter</type>
             <multiplicity>*</multiplicity>
@@ -489,7 +489,7 @@ under the License.
           <name>roleHint</name>
           <version>1.0.0</version>
           <type>String</type>
-          <description></description>
+          <description>The Plexus role hint to disambiguate multiple implementations of the same role (used to identify specific component instances).</description>
         </field>
         <field xml.tagName="field-name">
           <name>fieldName</name>