diff --git a/lib/internal/Magento/Framework/Console/CommandList.php b/lib/internal/Magento/Framework/Console/CommandList.php
index eddfd4e084536..f1c3c175b52b8 100644
--- a/lib/internal/Magento/Framework/Console/CommandList.php
+++ b/lib/internal/Magento/Framework/Console/CommandList.php
@@ -8,6 +8,7 @@
 
 /**
  * Class CommandList has a list of commands, which can be extended via DI configuration.
+ * @api
  */
 class CommandList implements CommandListInterface
 {
@@ -17,7 +18,16 @@ class CommandList implements CommandListInterface
     protected $commands;
 
     /**
-     * Constructor
+     * CommandList constructor is being used for injecting new Commands
+     *
+     * Registration of new Commands can be done using `di.xml`:
+     *  <type name="Magento\Framework\Console\CommandList">
+     *  <arguments>
+     *       <argument name="commands" xsi:type="array">
+     *           <item name="your-command-name" xsi:type="object">Vendor\Module\Console\Command\YourCommand</item>
+     *       </argument>
+     *  </arguments>
+     *  </type>
      *
      * @param array $commands
      */
@@ -27,9 +37,9 @@ public function __construct(array $commands = [])
     }
 
     /**
-     * {@inheritdoc}
+     * @inheritdoc
      */
-    public function getCommands()
+    public function getCommands(): array
     {
         return $this->commands;
     }