From a541c33264b1dca39f0fe62cc513cef7b160cf90 Mon Sep 17 00:00:00 2001
From: Navarr Barnier <navarr@mediotype.com>
Date: Tue, 31 Jul 2018 16:23:40 -0400
Subject: [PATCH 1/2] Add ReadFactory and WriteFactory to Magento's public API

These classes are necessary/useful for creating instances of
ReadInterface and WriteInterface using the public API.
---
 .../Magento/Framework/Filesystem/File/ReadFactory.php     | 6 +++++-
 .../Magento/Framework/Filesystem/File/WriteFactory.php    | 8 ++++++--
 2 files changed, 11 insertions(+), 3 deletions(-)

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')
     {

From 2a3562f77e816688c1e25c9ea342dc82456ecf42 Mon Sep 17 00:00:00 2001
From: Navarr Barnier <navarr@mediotype.com>
Date: Tue, 31 Jul 2018 16:30:23 -0400
Subject: [PATCH 2/2] Add directory WriteInterface and ReadInterface

---
 .../Magento/Framework/Filesystem/Directory/ReadInterface.php    | 2 +-
 .../Magento/Framework/Filesystem/Directory/WriteInterface.php   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

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
 {