Upadted README.md, added CONTRIBUTING.md and MIGRATING.md

Author: KatteriSharath

CONTRIBUTING.md

@@ -0,0 +1,9 @@
++ Thanks for contributing to the Authorize.Net Ruby SDK.
+
++ Before you submit a pull request, we ask that you consider the following:
+
+     - Submit an issue to state the problem your pull request solves or the funtionality that it adds. We can then advise on the feasability of the pull request, and let you know if there are other possible solutions.
+     - Part of the SDK is auto-generated based on the XML schema. Due to this auto-generation, we cannot merge contributions for request or response classes. You are welcome to open an issue to report problems or suggest improvements. Auto-generated classes include all files inside[lib/authorize_net/api/schema.rb](https://github.com/AuthorizeNet/sdk-ruby/tree/master/lib/authorize_net/api)  and [lib/authorize_net/api/transaction.rb](https://github.com/AuthorizeNet/sdk-ruby/tree/master/lib/authorize_net/api) folders, except [lib/authorize_net/api/api_transaction.rb](https://github.com/AuthorizeNet/sdk-ruby/tree/master/lib/authorize_net/api).
+     - Files marked as deprecated are no longer supported. Issues and pull requests for changes to these deprecated files will be closed.
+     - Recent changes will be in [the future branch](https://github.com/AuthorizeNet/sdk-ruby/tree/future). Before submitting an issue or pull request, check the future branch first to see if a fix has already been merged.
+     - **Always use the future branch for pull requests.** We will first merge pull requests to the future branch, before pushing to the master branch for the next release.

MIGRATING.md

@@ -0,0 +1,51 @@
+# Migrating from Legacy Authorize.Net Classes
+
+Authorize.Net no longer supports several legacy classes, including AIM, ARB and others listed below, as part of sdk-dotnet. If you are using any of these, we recommend that you update your code to use the new Authorize.Net API classes under (sdk-ruby/lib/authorize_net/api).
+
+**For details on the deprecation and replacement of legacy Authorize.Net APIs, visit https://developer.authorize.net/api/upgrade_guide/.**
+
+## Full list of classes that are no longer supported
+| Class                               | New Feature                                                                                                                                                    | Sample Codes directory/repository                                                 |
+|-------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
+| AIM (Authorize.NET/AIM)             | [PaymentTransactions](https://developer.authorize.net/api/reference/index.html#payment-transactions)                                                           | [sample-code-csharp/PaymentTransactions](https://github.com/AuthorizeNet/sample-code-csharp/tree/master/PaymentTransactions)    |
+| ARB (Authorize.NET/ARB)             | [RecurringBilling](https://developer.authorize.net/api/reference/index.html#recurring-billing)                                                                 | [sample-code-csharp/Recurring Billing](https://github.com/AuthorizeNet/sample-code-csharp/tree/master/RecurringBilling)          | 
+| CIM (Authorize.NET/CIM)             | [CustomerProfiles](https://developer.authorize.net/api/reference/index.html#customer-profiles)                                                                 | [sample-code-csharp/CustomerProfiles](https://github.com/AuthorizeNet/sample-code-csharp/tree/master/CustomerProfiles)          |
+| SIM (Authorize.NET/SIM)             | [Accept Hosted](https://developer.authorize.net/content/developer/en_us/api/reference/features/accept_hosted.html)                                             | Not available                                                                                                                         |
+| Reporting	(Authorize.NET/Reporting) | [TransactionReporting](https://developer.authorize.net/api/reference/index.html#transaction-reporting)                                                          | [Sample Accept Application](https://github.com/AuthorizeNet/accept-sample-app)    |
+
+## Example 
+#### Corresponding new model code (charge-credit-card):
+   ```Ruby
+require 'rubygems'
+require 'yaml'
+require 'authorizenet' 
+require 'securerandom'
+
+  include AuthorizeNet::API
+
+  def charge_credit_card()
+    config = YAML.load_file(File.dirname(__FILE__) + "/../credentials.yml")
+    
+	# Set the request to operate in either the sandbox or production environment
+    transaction = Transaction.new(config["api_login_id"], config["api_transaction_key"], :gateway => :sandbox)
+  
+    # Create the payment transaction object
+    request = CreateTransactionRequest.new
+    
+	# Populate the payment data
+    request.transactionRequest = TransactionRequestType.new()
+    request.transactionRequest.amount = ((SecureRandom.random_number + 1 ) * 150 ).round(2)
+    request.transactionRequest.payment = PaymentType.new
+    request.transactionRequest.payment.creditCard = CreditCardType.new("4242424242424242","0220","123") 
+    request.transactionRequest.customer = CustomerDataType.new(CustomerTypeEnum::Individual,"CUST-1234","[email protected]",DriversLicenseType.new("DrivLicenseNumber123","WA","05/05/1990"),"123456789")
+      
+    # call the Transaction and get the response    
+    response = transaction.create_transaction(request)    
+    
+    return response
+  end
+  
+if __FILE__ == $0
+  charge_credit_card()
+end
+```

README.md

@@ -17,6 +17,13 @@ AIM, ARB, CIM, Reporting and SIM have all been deprecated in favor of AuthorizeN
 * RSpec 2.1 or higher (to run rspec tests)
 * An Authorize.Net account (see _Registration & Configuration_ section below)
 
+### Migrating from older versions  
+ Since August 2018, the Authorize.Net API has been reorganized to be more merchant focused. AuthorizeNetAIM, AuthorizeNetARB, AuthorizeNetCIM, Reporting and AuthorizeNetSIM classes have all been deprecated in favor of `sdk-ruby/lib/authorize_net/api` . To see the full list of mapping of new features corresponding to the deprecated features, you can see [MIGRATING.md](MIGRATING.md).  
+
+### Contribution  
+  - If you need information or clarification about any Authorize.Net features, please create an issue for it. Also you can search in the [Authorize.Net developer community](https://community.developer.authorize.net/).  
+  - Before creating pull requests, please read [the contributors guide](CONTRIBUTING.md)
+  
 ### TLS 1.2
 The Authorize.Net APIs only support connections using the TLS 1.2 security protocol. It's important to make sure you have new enough versions of all required components to support TLS 1.2. Additionally, it's very important to keep these components up to date going forward to mitigate the risk of any security flaws that may be discovered in your system or any libraries it uses.