diff --git a/lib/internal/Magento/Framework/Filesystem/Directory/ReadInterface.php b/lib/internal/Magento/Framework/Filesystem/Directory/ReadInterface.php
index 5519245ec24b4..61108c64dda44 100644
--- a/lib/internal/Magento/Framework/Filesystem/Directory/ReadInterface.php
+++ b/lib/internal/Magento/Framework/Filesystem/Directory/ReadInterface.php
@@ -7,7 +7,7 @@
 
 /**
  * Interface \Magento\Framework\Filesystem\Directory\ReadInterface
- *
+ * @api
  */
 interface ReadInterface
 {
diff --git a/lib/internal/Magento/Framework/Filesystem/Directory/WriteInterface.php b/lib/internal/Magento/Framework/Filesystem/Directory/WriteInterface.php
index c72651a78dad3..186cbcb81bff2 100644
--- a/lib/internal/Magento/Framework/Filesystem/Directory/WriteInterface.php
+++ b/lib/internal/Magento/Framework/Filesystem/Directory/WriteInterface.php
@@ -7,7 +7,7 @@
 
 /**
  * Interface \Magento\Framework\Filesystem\Directory\WriteInterface
- *
+ * @api
  */
 interface WriteInterface extends ReadInterface
 {
diff --git a/lib/internal/Magento/Framework/Filesystem/File/ReadFactory.php b/lib/internal/Magento/Framework/Filesystem/File/ReadFactory.php
index 38b581da752b7..5d9badf42073f 100644
--- a/lib/internal/Magento/Framework/Filesystem/File/ReadFactory.php
+++ b/lib/internal/Magento/Framework/Filesystem/File/ReadFactory.php
@@ -8,6 +8,10 @@
 use Magento\Framework\Filesystem\DriverInterface;
 use Magento\Framework\Filesystem\DriverPool;
 
+/**
+ * Opens a file for reading
+ * @api
+ */
 class ReadFactory
 {
     /**
@@ -28,7 +32,7 @@ public function __construct(DriverPool $driverPool)
     }
 
     /**
-     * Create a readable file
+     * Create a {@see ReaderInterface}
      *
      * @param string $path
      * @param DriverInterface|string $driver Driver or driver code
diff --git a/lib/internal/Magento/Framework/Filesystem/File/WriteFactory.php b/lib/internal/Magento/Framework/Filesystem/File/WriteFactory.php
index a45d6a62488f6..af2a43ceaedc3 100644
--- a/lib/internal/Magento/Framework/Filesystem/File/WriteFactory.php
+++ b/lib/internal/Magento/Framework/Filesystem/File/WriteFactory.php
@@ -8,6 +8,10 @@
 use Magento\Framework\Filesystem\DriverInterface;
 use Magento\Framework\Filesystem\DriverPool;
 
+/**
+ * Opens a file for reading and/or writing
+ * @api
+ */
 class WriteFactory extends ReadFactory
 {
     /**
@@ -29,12 +33,12 @@ public function __construct(DriverPool $driverPool)
     }
 
     /**
-     * Create a readable file.
+     * Create a {@see WriterInterface}
      *
      * @param string $path
      * @param DriverInterface|string $driver Driver or driver code
      * @param string $mode [optional]
-     * @return Write
+     * @return WriteInterface
      */
     public function create($path, $driver, $mode = 'r')
     {