Merge branch 'FearlessKiwis-MAGETWO-32634-define-public-api' of https://github.corp.ebay.com/magento-fearless-kiwis/magento2ce into develop

Robert He · Robert He · commit ae13ab459284 · 2015-05-08T16:09:06.000-05:00
diff --git a/app/code/Magento/Tax/Api/Data/AppliedTaxInterface.php b/app/code/Magento/Tax/Api/Data/AppliedTaxInterface.php
@@ -5,6 +5,10 @@
  */
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Applied tax interface.
+ * @api
+ */
 interface AppliedTaxInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/AppliedTaxRateInterface.php b/app/code/Magento/Tax/Api/Data/AppliedTaxRateInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Applied tax rate interface.
+ * @api
+ */
 interface AppliedTaxRateInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/QuoteDetailsInterface.php b/app/code/Magento/Tax/Api/Data/QuoteDetailsInterface.php
@@ -6,7 +6,10 @@
 
 namespace Magento\Tax\Api\Data;
 
-
+/**
+ * Quote details interface.
+ * @api
+ */
 interface QuoteDetailsInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/QuoteDetailsItemInterface.php b/app/code/Magento/Tax/Api/Data/QuoteDetailsItemInterface.php
@@ -5,6 +5,10 @@
  */
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Quote details item interface.
+ * @api
+ */
 interface QuoteDetailsItemInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxClassInterface.php b/app/code/Magento/Tax/Api/Data/TaxClassInterface.php
@@ -7,6 +7,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Tax class interface.
+ * @api
+ */
 interface TaxClassInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxClassKeyInterface.php b/app/code/Magento/Tax/Api/Data/TaxClassKeyInterface.php
@@ -8,6 +8,10 @@
 
 use Magento\Framework\Api\ExtensibleDataInterface;
 
+/**
+ * Tax class key interface.
+ * @api
+ */
 interface TaxClassKeyInterface extends ExtensibleDataInterface
 {
     /**#@+
diff --git a/app/code/Magento/Tax/Api/Data/TaxClassSearchResultsInterface.php b/app/code/Magento/Tax/Api/Data/TaxClassSearchResultsInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Interface for tax class search results.
+ * @api
+ */
 interface TaxClassSearchResultsInterface extends \Magento\Framework\Api\SearchResultsInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxDetailsInterface.php b/app/code/Magento/Tax/Api/Data/TaxDetailsInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Tax details interface.
+ * @api
+ */
 interface TaxDetailsInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxDetailsItemInterface.php b/app/code/Magento/Tax/Api/Data/TaxDetailsItemInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Tax details items interface.
+ * @api
+ */
 interface TaxDetailsItemInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxRateInterface.php b/app/code/Magento/Tax/Api/Data/TaxRateInterface.php
@@ -7,6 +7,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Tax rate interface.
+ * @api
+ */
 interface TaxRateInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxRateSearchResultsInterface.php b/app/code/Magento/Tax/Api/Data/TaxRateSearchResultsInterface.php
@@ -9,6 +9,10 @@
 
 use Magento\Framework\Api\SearchResultsInterface;
 
+/**
+ * Interface for tax rate search results.
+ * @api
+ */
 interface TaxRateSearchResultsInterface extends SearchResultsInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxRateTitleInterface.php b/app/code/Magento/Tax/Api/Data/TaxRateTitleInterface.php
@@ -7,6 +7,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Tax rate title interface.
+ * @api
+ */
 interface TaxRateTitleInterface extends \Magento\Framework\Api\ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxRuleInterface.php b/app/code/Magento/Tax/Api/Data/TaxRuleInterface.php
@@ -8,6 +8,10 @@
 
 use Magento\Framework\Api\ExtensibleDataInterface;
 
+/**
+ * Tax rule interface.
+ * @api
+ */
 interface TaxRuleInterface extends ExtensibleDataInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/Data/TaxRuleSearchResultsInterface.php b/app/code/Magento/Tax/Api/Data/TaxRuleSearchResultsInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api\Data;
 
+/**
+ * Interface for tax rule search results.
+ * @api
+ */
 interface TaxRuleSearchResultsInterface extends \Magento\Framework\Api\SearchResultsInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/TaxCalculationInterface.php b/app/code/Magento/Tax/Api/TaxCalculationInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api;
 
+/**
+ * Tax calculation interface.
+ * @api
+ */
 interface TaxCalculationInterface
 {
     /**#@+
diff --git a/app/code/Magento/Tax/Api/TaxClassManagementInterface.php b/app/code/Magento/Tax/Api/TaxClassManagementInterface.php
@@ -7,6 +7,10 @@
 
 namespace Magento\Tax\Api;
 
+/**
+ * Interface for managing classes rates.
+ * @api
+ */
 interface TaxClassManagementInterface
 {
     /**#@+
diff --git a/app/code/Magento/Tax/Api/TaxClassRepositoryInterface.php b/app/code/Magento/Tax/Api/TaxClassRepositoryInterface.php
@@ -7,6 +7,10 @@
 
 namespace Magento\Tax\Api;
 
+/**
+ * Tax class CRUD interface.
+ * @api
+ */
 interface TaxClassRepositoryInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/TaxRateManagementInterface.php b/app/code/Magento/Tax/Api/TaxRateManagementInterface.php
@@ -8,6 +8,10 @@
 
 use Magento\Tax\Api\Data\TaxRateInterface;
 
+/**
+ * Interface for managing tax rates.
+ * @api
+ */
 interface TaxRateManagementInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/TaxRateRepositoryInterface.php b/app/code/Magento/Tax/Api/TaxRateRepositoryInterface.php
@@ -7,6 +7,10 @@
 
 namespace Magento\Tax\Api;
 
+/**
+ * Tax rate CRUD interface.
+ * @api
+ */
 interface TaxRateRepositoryInterface
 {
     /**
diff --git a/app/code/Magento/Tax/Api/TaxRuleRepositoryInterface.php b/app/code/Magento/Tax/Api/TaxRuleRepositoryInterface.php
@@ -6,6 +6,10 @@
 
 namespace Magento\Tax\Api;
 
+/**
+ * Tax rule CRUD interface.
+ * @api
+ */
 interface TaxRuleRepositoryInterface
 {
     /**

Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,10 @@`
`6`	`6`
`7`	`7`	`namespace Magento\Tax\Api\Data;`
`8`	`8`
	`9`	`+/**`
	`10`	`+ * Applied tax rate interface.`
	`11`	`+ * @api`
	`12`	`+ */`
`9`	`13`	`interface AppliedTaxRateInterface extends \Magento\Framework\Api\ExtensibleDataInterface`
`10`	`14`	`{`
`11`	`15`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,10 @@`
`7`	`7`
`8`	`8`	`namespace Magento\Tax\Api\Data;`
`9`	`9`
	`10`	`+/**`
	`11`	`+ * Tax class interface.`
	`12`	`+ * @api`
	`13`	`+ */`
`10`	`14`	`interface TaxClassInterface extends \Magento\Framework\Api\ExtensibleDataInterface`
`11`	`15`	`{`
`12`	`16`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -8,6 +8,10 @@`
`8`	`8`
`9`	`9`	`use Magento\Framework\Api\ExtensibleDataInterface;`
`10`	`10`
	`11`	`+/**`
	`12`	`+ * Tax class key interface.`
	`13`	`+ * @api`
	`14`	`+ */`
`11`	`15`	`interface TaxClassKeyInterface extends ExtensibleDataInterface`
`12`	`16`	`{`
`13`	`17`	`/**#@+`