MAGETWO-35004: Investigate and Annotate @api to classes and/or methods

Author: Dale Sikkema

lib/internal/Magento/Framework/App/Config/Data.php

@@ -42,10 +42,7 @@ public function getSource()
     }
 
     /**
-     * Retrieve configuration value by path
-     *
-     * @param null|string $path
-     * @return array|string
+     * @inheritdoc
      */
     public function getValue($path = null)
     {
@@ -65,11 +62,7 @@ public function getValue($path = null)
     }
 
     /**
-     * Set configuration value
-     *
-     * @param string $path
-     * @param mixed $value
-     * @return void
+     * @inheritdoc
      */
     public function setValue($path, $value)
     {

lib/internal/Magento/Framework/App/Config/DataInterface.php

@@ -6,17 +6,23 @@
 namespace Magento\Framework\App\Config;
 
 /**
+ * Configuration data storage
+ *
  * @api
  */
 interface DataInterface
 {
     /**
+     * Retrieve configuration value by path
+     *
      * @param string|null $path
-     * @return string|array
+     * @return mixed
      */
     public function getValue($path);
 
     /**
+     * Set configuration value by path
+     *
      * @param string $path
      * @param mixed $value
      * @return void

lib/internal/Magento/Framework/Locale/Currency.php

@@ -49,20 +49,15 @@ public function __construct(
     }
 
     /**
-     * Retrieve currency code
-     *
-     * @return string
+     * @inheritdoc
      */
     public function getDefaultCurrency()
     {
         return self::DEFAULT_CURRENCY;
     }
 
     /**
-     * Create \Zend_Currency object for current locale
-     *
-     * @param   string $currency
-     * @return  \Magento\Framework\Currency
+     * @inheritdoc
      */
     public function getCurrency($currency)
     {

lib/internal/Magento/Framework/Locale/CurrencyInterface.php

@@ -13,14 +13,14 @@
 interface CurrencyInterface
 {
     /**
-     * Retrieve currency code
+     * Retrieve default currency code
      *
      * @return string
      */
     public function getDefaultCurrency();
 
     /**
-     * Create \Magento\Framework\Currency object for current locale
+     * Create Currency object for current locale
      *
      * @param   string $currency
      * @return  \Magento\Framework\Currency