Merge pull request #271869 from mayssamm/main

update ACS Rooms quickstarts to remove pstnDialOutEnabled public preview status

Author: prmerger-automator[bot]

articles/communication-services/quickstarts/rooms/get-started-rooms.md

@@ -19,19 +19,17 @@ This quickstart helps you get started with Azure Communication Services Rooms. A
 
 ## Object model
 
-The table below lists the main properties of `room` objects:
+The following table lists the main properties of `room` objects:
 
 | Name                  | Description                               |
 |-----------------------|-------------------------------------------|
 | `roomId`              | Unique `room` identifier.                  |
 | `validFrom`           | Earliest time a `room` can be used. |
 | `validUntil`          | Latest time a `room` can be used. |
-| `pstnDialOutEnabled`*  | Enable or disable dialing out to a PSTN number in a room.|
+| `pstnDialOutEnabled`  | Enable or disable dialing out to a PSTN number in a room.|
 | `participants`        | List of participants to a `room`. Specified as a `CommunicationIdentifier`. |
 | `roleType`            | The role of a room participant. Can be either `Presenter`, `Attendee`, or `Consumer`. |
 
-*pstnDialOutEnabled is currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/)
-
 ::: zone pivot="platform-azcli"
 [!INCLUDE[Use rooms with Azure CLI](./includes/rooms-quickstart-az-cli.md)]
 ::: zone-end
@@ -63,7 +61,7 @@ This quickstart helps you get started with Azure Communication Services Rooms. A
 
 ## Next steps
 
-Once you've created the room and configured it, you can learn how to [join a rooms call](join-rooms-call.md).
+You can learn how to [join a rooms call](join-rooms-call.md) after creating and configuring the room.
 
 In this section you learned how to:
 > [!div class="checklist"]

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-az-cli.md

@@ -29,7 +29,7 @@ az extension add --name communication
 ```
 
 ### Sign in to Azure CLI
-You'll need to [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal and providing your credentials.
+You need to [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in by running the ```az login``` command from the terminal and providing your credentials.
 
 
 ### Store your connection string in an environment variable 
@@ -42,7 +42,7 @@ You can configure the `AZURE_COMMUNICATION_CONNECTION_STRING` environment variab
 setx AZURE_COMMUNICATION_CONNECTION_STRING "<connectionString>"
 ```
 
-After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example. 
+After you add the environment variable, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example. 
 
 ##### [macOS](#tab/unix)
 
@@ -52,7 +52,7 @@ Edit your **`.zshrc`**, and add the environment variable:
 export AZURE_COMMUNICATION_CONNECTION_STRING="<connectionString>"
 ```
 
-After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable. 
+After you add the environment variable, run `source ~/.zshrc` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable. 
 
 ##### [Linux](#tab/linux)
 
@@ -62,7 +62,7 @@ Edit your **`.bash_profile`**, and add the environment variable:
 export AZURE_COMMUNICATION_CONNECTION_STRING="<connectionString>"
 ```
 
-After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you may need to close and reopen the editor, IDE, or shell in order to access the variable. 
+After you add the environment variable, run `source ~/.bash_profile` from your console window to make the changes effective. If you created the environment variable with your IDE open, you might need to close and reopen the editor, IDE, or shell in order to access the variable. 
 
 ---
 
@@ -76,22 +76,20 @@ Use the `rooms create` command to create a room.
 az communication rooms create --presenter-participants "<participantId>" --consumer-participants "<participantId>" --attendee-participant "<participantId>" --valid-from "<valid-from>" --valid-until "<valid-until>" --pstn-dial-out-enabled "<pstn-dial-out-enabled>" --connection-string "<connection-string>"
 ```
 
-- Use `<participantId>` optionally to specify the type of participant as presenter-participants, consumer-participants, or attendee-participants. If you do not specify a value, the default is empty. 
+- Use `<participantId>` optionally to specify the type of participant as presenter-participants, consumer-participants, or attendee-participants. If you don't specify a value, the default is empty. 
 - Replace `<connection-string>` with your Azure Communication Services connection string. 
 - Use `<valid-from>` optionally to specify the timestamp when the room is open for joining, in ISO8601 format, ex: 2022-07-14T10:21. 
 - Use `<valid-until>` optionally to specify the timestamp when the room can no longer be joined, in ISO8601 format, ex: 2022-07-14T10:21. 
-- Use `<pstn-dial-out-enabled>`* optionally by setting this flag ("True" or "False") to enable or disable PSTN dial out for a room. By default, this flag is set to "False" when creating a room.
-
-*`<pstn-dial-out-enabled>` is currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/)
+- Use `<pstn-dial-out-enabled>` optionally by setting this flag ("True" or "False") to enable or disable PSTN dial out for a room. By default, this flag is set to "False" when creating a room.
 
 If you've stored the connection string in environment variables as stated above, you won't need to pass them to the command.
 
 ```azurecli-interactive
 az communication rooms create 
 ```
 
-### Enable PSTN Dial Out Capability for a Room (Currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/))
-The PSTN dial out can be enabled during `rooms create` by defining the `--pstn-dial-out-enabled` parameter as "True". This capability may also be modified during `rooms update` by specifying the `--pstn-dial-out-enabled` parameter.
+### Enable PSTN dial out capability for a room
+The PSTN dial out can be enabled during `rooms create` by defining the `--pstn-dial-out-enabled` parameter as "True". This capability can also be modified during `rooms update` by specifying the `--pstn-dial-out-enabled` parameter.
 
 ```azurecli-interactive
 az communication rooms create --pstn-dial-out-enabled "<pstn-dial-out-enabled>" --connection-string "<connection-string>"
@@ -101,7 +99,7 @@ az communication rooms create --pstn-dial-out-enabled "<pstn-dial-out-enabled>"
 az communication rooms update --pstn-dial-out-enabled "<pstn-dial-out-enabled>" --room "<roomId>"
 ```
 
-- Use `<pstn-dial-out-enabled>` set this flag ("True" or "False") to enable or disable PSTN dial out for a room.
+- To enable or disable PSTN dial out for a room, set `<pstn-dial-out-enabled>` flag ("True" or "False").
 
 ### Get the rooms 
 
@@ -144,13 +142,13 @@ Use the `identity user create` command to create a new participant, identified b
 az communication identity user create
 ```
 
-Add a user as a participant to the room 
+Add a user as a participant to the room.
 
 ```azurecli-interactive
 az communication rooms participant add-or-update --attendee-participant "<participantId>" --room "<roomId>"
 ```
 
-- Replace `<participantId>` with your participant ID. If the `<participantId>` does not exist in the room, the participant will be added to the room as an attendee role. Otherwise, the participant's role is updated to an attendee role.
+- Replace `<participantId>` with your participant ID. If the `<participantId>` doesn't exist in the room, the participant will be added to the room as an attendee role. Otherwise, the participant's role is updated to an attendee role.
 - Replace `<roomId>` with your room ID.
 
 ### Get list of participants in a room

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-call-ios.md

@@ -25,10 +25,10 @@ In Xcode, create a new iOS project and select the Single View App template. This
 :::image type="content" source="../../voice-video-calling/media/ios/xcode-new-ios-project.png" alt-text="Screenshot showing the New Project window within Xcode.":::
 
 ### Installing CocoaPods
-Please use this guide to [install CocoaPods](https://guides.cocoapods.org/using/getting-started.html) on your Mac. 
+Use this guide to [install CocoaPods](https://guides.cocoapods.org/using/getting-started.html) on your Mac. 
 
 ### Install the package and dependencies with CocoaPods
-1. To create a Podfile for your application open the terminal and navigate to the project folder and run pod init.
+1. To create a Podfile for your application, open the terminal and navigate to the project folder and run pod init.
 
 2. Add the following code to the Podfile and save:
 
@@ -43,11 +43,11 @@ end
 
 3. Run pod install.
 
-4. Open the .xcworkspace with Xcode.
+4. Open the `.xcworkspace` file with Xcode.
 
 
-### Request access to the Microphone and Camera
-To access the device's microphone and camera, you need to update your app's Information Property List with an `NSMicrophoneUsageDescription` and `NSCameraUsageDescription`. You set the associated value to a string that will be included in the dialog the system uses to request access from the user.
+### Request access to the microphone and camera
+To access the device's microphone and camera, you need to update your app's Information Property List with `NSMicrophoneUsageDescription` and `NSCameraUsageDescription`. Set the associated value to a string that will be included in the dialog the system uses to request access from the user.
 
 Right-click the `Info.plist` entry of the project tree and select Open As > Source Code. Add the following lines the top level `<dict>` section, and then save the file.
 
@@ -74,11 +74,11 @@ The following classes and interfaces handle some of the major features of the Az
 | CallClient                   | The CallClient is the main entry point to the Calling SDK.                                                                                                                         |
 | CallAgent                    | The CallAgent is used to start and manage calls.                                                                                                                                   |
 | CommunicationTokenCredential | The CommunicationTokenCredential is used as the token credential to instantiate the CallAgent.                                                                                     |
-| CommunicationIdentifier      | The CommunicationIdentifier is used to represent the identity of the user which can be one of the following: CommunicationUserIdentifier/PhoneNumberIdentifier/CallingApplication. |
+| CommunicationIdentifier      | The CommunicationIdentifier is used to represent the identity of the user, and can have one of the following values: CommunicationUserIdentifier/PhoneNumberIdentifier/CallingApplication. |
 | RoomCallLocator | The RoomCallLocator is used by CallAgent to join a Room call|
 
 ## Create the Call Agent
-Replace the implementation of the ContentView struct with some simple UI controls that enable a user to initiate and end a call. We will attach business logic to these controls in this quickstart.
+Replace the implementation of the ContentView struct with some simple UI controls that enable a user to initiate and end a call. We'll attach business logic to these controls in this quickstart.
 
 ```Swift
 struct ContentView: View {    
@@ -199,10 +199,10 @@ struct HomePageView_Previews: PreviewProvider {
 }
 ```
 
-### Authenticate the Client
-In order to initialize a CallAgent instance we need a User Access Token which will enable us to join Room calls. 
+### Authenticate the client
+In order to initialize a CallAgent instance, we need a User Access Token which will enable us to join Room calls. 
 
-Once you have a token, Add the following code to the `onAppear` callback in `ContentView.swift`. You will need to replace `<USER ACCESS TOKEN>` with a valid user access token for your resource:
+Once you have a token, add the following code to the `onAppear` callback in `ContentView.swift`. You need to replace `<USER ACCESS TOKEN>` with a valid user access token for your resource:
 
 ```Swift
 var userCredential: CommunicationTokenCredential?
@@ -325,7 +325,7 @@ private func leaveRoomCall() {
 ```
 
 ## Broadcasting video
-During a Room call we can use `startVideo` or `stopVideo` to start or stop sending `LocalVideoStream` to remote participants.
+During a Room call, we can use `startVideo` or `stopVideo` to start or stop sending `LocalVideoStream` to remote participants.
 
 ```Swift
 func toggleLocalVideo() {
@@ -422,7 +422,7 @@ self.callAgent!.delegate = callHandler
 ```
 
 ## Remote participant management
-All remote participants are represented by the `RemoteParticipant` type and are available through the `remoteParticipants` collection on a call instance. We can implement a `Participant` class to manage the updates on remote video streams of remote participants amongst other things.
+All remote participants are represented by the `RemoteParticipant` type and are available through the `remoteParticipants` collection on a call instance. We can implement a `Participant` class to manage the updates on remote video streams of remote participants among other things.
 
 ```swift
 class Participant: NSObject, RemoteParticipantDelegate, ObservableObject {

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-java.md

@@ -27,15 +27,15 @@ You can review and download the sample code for this quick start on [GitHub](htt
 
 ### Create a new Java application
 
-In a console window (such as cmd, PowerShell, or Bash), use the `mvn` command below to create a new console app with the name `rooms-quickstart`. This command creates a simple "Hello World" Java project with a single source file: **App.java**.
+In a console window (such as cmd, PowerShell, or Bash), use the `mvn` command to create a new console app with the name `rooms-quickstart`. This command creates a simple "Hello World" Java project with a single source file: **App.java**.
 
 ```console
 mvn archetype:generate -DgroupId=com.communication.quickstart -DartifactId=communication-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
 ```
 
 ### Include the package
 
-You'll need to use the Azure Communication Rooms client library for Java [version 1.0.0](https://search.maven.org/artifact/com.azure/azure-communication-rooms/1.0.0/jar) or above.
+You need to use the Azure Communication Rooms client library for Java [version 1.1.0](https://search.maven.org/artifact/com.azure/azure-communication-rooms/1.1.0/jar) or above.
 
 #### Include the BOM file
 
@@ -123,7 +123,7 @@ RoomsClient roomsClient = new RoomsClientBuilder().connectionString(connectionSt
 ## Create a room
 
 ### Set up room participants
-In order to set up who can join a room, you'll need to have the list of the identities of those users. You can follow the instructions [here](../../identity/access-tokens.md?pivots=programming-language-java) for creating users and issuing access tokens. Alternatively, if you want to create the users on demand, you can create them using the `CommunicationIdentityClient`.
+In order to set up who can join a room, you need to have the list of the identities of those users. You can follow the instructions [here](../../identity/access-tokens.md?pivots=programming-language-java) for creating users and issuing access tokens. Alternatively, if you want to create the users on demand, you can create them using the `CommunicationIdentityClient`.
 
 To use `CommunicationIdentityClient`, add the following package:
 
@@ -184,11 +184,9 @@ System.out.println("\nCreated a room with id: " + roomCreated.getRoomId());
 
 ```
 
-*setPstnDialOutEnabled is currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/)
-
 Since `rooms` are server-side entities, you may want to keep track of and persist the `roomId` in the storage medium of choice. You can reference the `roomId` to view or update the properties of a `room` object.
 
-### Enable PSTN Dial Out Capability for a Room (Currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/))
+### Enable PSTN dial out capability for a room
 Each `room` has PSTN dial out disabled by default. The PSTN dial out can be enabled for a `room` at creation, by defining the `pstnDialOutEnabled` parameter as true. This capability may also be modified for a `room` by issuing an update request for the `pstnDialOutEnabled` parameter.
 
 ```java
@@ -360,7 +358,7 @@ mvn package
 
 ```
 
-Execute the app
+Execute the app.
 
 ```console
 mvn exec:java -D"exec.mainClass"="com.communication.rooms.quickstart" -D"exec.cleanupDaemonThreads"="false"

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-javascript.md

@@ -42,7 +42,7 @@ Create a new file `index.js` where the code for this quickstart will be added.
 
 ### Install the packages
 
-You'll need to use the Azure Communication Rooms client library for JavaScript [version 1.0.0](https://www.npmjs.com/package/@azure/communication-rooms) or above.
+You need to use the Azure Communication Rooms client library for JavaScript [version 1.1.0](https://www.npmjs.com/package/@azure/communication-rooms) or above.
 
 Use the `npm install` command to install the below Communication Services SDKs for JavaScript.
 
@@ -52,7 +52,7 @@ npm install @azure/communication-rooms --save
 
 ### Set up the app framework
 
-In the `index.js` file add the following code. We will be adding the code for the quickstart in the `main` function.
+In the `index.js` file, add the following code. We'll be adding the code for the quickstart in the `main` function.
 
 ``` javascript
 const { RoomsClient } = require('@azure/communication-rooms');
@@ -89,7 +89,7 @@ const roomsClient = new RoomsClient(connectionString);
 
 ### Set up room participants
 
-In order to set up who can join a room, you'll need to have the list of the identities of those users. You can follow the instructions [here](../../identity/access-tokens.md?pivots=programming-language-javascript) for creating users and issuing access tokens. Alternatively, if you want to create the users on demand, you can create them using the `CommunicationIdentityClient`.
+In order to set up who can join a room, you need to have the list of the identities of those users. You can follow the instructions [here](../../identity/access-tokens.md?pivots=programming-language-javascript) for creating users and issuing access tokens. Alternatively, if you want to create the users on demand, you can create them using the `CommunicationIdentityClient`.
 
 To use the CommunicationIdentityClient, install the following npm package:
 
@@ -147,11 +147,10 @@ const createRoom = await roomsClient.createRoom(createRoomOptions);
 const roomId = createRoom.id;
 console.log("\nCreated a room with id: ", roomId);
 ```
-*pstnDialOutEnabled is currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/)
 
 Since `rooms` are server-side entities, you may want to keep track of and persist the `roomId` in the storage medium of choice. You can reference the `roomId` to view or update the properties of a `room` object.
 
-### Enable PSTN Dial Out Capability for a Room (Currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/))
+### Enable PSTN dial out capability for a room
 Each `room` has PSTN dial out disabled by default. The PSTN dial out can be enabled for a `room` at creation, by defining the `pstnDialOutEnabled` parameter as true. This capability may also be modified for a `room` by issuing an update request for the `pstnDialOutEnabled` parameter.
 
 ```javascript