Updated, added new references

Author: wiazur

README.md

@@ -15,38 +15,36 @@ urlFragment: cognitive-services-REST-api-samples
 
 # Samples for REST APIs in Cognitive Services
 
-This repo provides code samples for cognitive services APIs. There are sections for Language, Search, and Vision APIs using various progamming languages. Note that these are just simple wrappers to the APIs. For SDKs and SDK samples there are separate repos. You can check out all cognitive services APIs here: https://azure.microsoft.com/en-us/services/cognitive-services/. You can check out detailed documentation of these APIs here: https://docs.microsoft.com/en-us/azure/#pivot=products&panel=cognitive.
-
-## Features
-
-Code samples (aka API wrappers) in multiple languages. Check out https://azure.microsoft.com/en-us/services/cognitive-services/ for the latest and greatest version of the APIs.
+This repo provides code samples for Azure Cognitive Services APIs. There are sections for Language, Search, and Vision, using various progamming languages. Note that these are just simple wrappers to the APIs. For SDKs and SDK samples there are separate repos. You can check out all Cognitive Services here: https://azure.microsoft.com/en-us/services/cognitive-services/. You can check out detailed documentation of these APIs here: https://docs.microsoft.com/en-us/azure/cognitive-services/.
 
 ## Getting Started
 
-All wrappers require at least two steps:
-  1. Copy the sample in your favorite IDE.
-  2. Get access key of your API and insert in the code. Build/Compile/Run your code.
-  
-You can get free access keys from here: https://azure.microsoft.com/en-us/try/cognitive-services/?api=bing-web-search-api. You can buy access keys from here: https://portal.azure.com/#create/Microsoft.CognitiveServicesBingSearch-v7.
+These REST samples require some steps:
+  1. Copy the sample into your favorite IDE or text editor.
+  1. Get a subscription key and endpoint from your API service (for example, Computer Vision or Bing Search, etc.) If you have not created the Azure service you need, go here to get a free (or paid) account: https://azure.microsoft.com/en-us/free/?WT.mc_id=A261C142F
+  1. Add your key and endpoint to your environment variables with the naming as shown in the code sample.
+  1. Install libraries if needed (instructions on the ones needed are in the sample).
+  1. Compile and run the sample through your IDE or the command line.
+  1. (Optional) You may want to download the whole repo first: 
+      `git clone https://github.com/Azure-Samples/cognitive-services-REST-api-samples`
 
-### Prerequisites
+## Resources
 
-1. Your favorite IDE. 
-2. Node.js samples are for Node.js 6 version.
-3. Java samples will need JDK 7 or 8 and will require gson library in some cases.
-4. For python, you will need 3.x version.
+- Cognitive Services REST APIs: https://westus.dev.cognitive.microsoft.com/docs/services/
+- Cognitive Services introduction: https://azure.microsoft.com/en-us/services/cognitive-services/
+- Documentation for Cognitive Services: https://docs.microsoft.com/en-us/azure/cognitive-services/
+- The Microsoft Azure portal: https://portal.azure.com/#home
+- Maven: https://mvnrepository.com/artifact/com.microsoft.azure.cognitiveservices
 
-### Quickstart
+## SDK Samples
 
-1. git clone https://github.com/Azure-Samples/cognitive-services-REST-api-samples
-2. cd cognitive-services-REST-api-samples
-3. Choose your language and sample and open in your favorite IDE. 
-3. Insert Access Key (and other parameters as required). See Getting Started section above for info on how to get keys.
-4. Build and Run.
+- Dotnet: https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples
+- Java: https://github.com/Azure-Samples/cognitive-services-java-sdk-samples
+- Node: https://github.com/Azure-Samples/cognitive-services-node-sdk-samples
+- Python: https://github.com/Azure-Samples/cognitive-services-python-sdk-samples
 
-## Resources
+### Service-specific SDK Samples
 
-- Project page: https://azure.microsoft.com/en-us/services/cognitive-services/
-- Documentation page cognitive services APIs: https://docs.microsoft.com/en-us/azure/#pivot=products&panel=cognitive
-- SDKs in different languages: For C# https://github.com/Azure/azure-sdk-for-net/ and similar folders for other languages.
-- Samples for SDKs: For C# https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples and similar for other languages.
+- Speech: https://github.com/Azure-Samples/cognitive-services-speech-sdk
+- Personalizer: https://github.com/Azure-Samples/cognitive-services-personalizer-samples
+- Content Moderator: https://github.com/Azure-Samples/cognitive-services-content-moderator-samples