Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into WI61565-deprecation

Author: ElazarK

articles/applied-ai-services/form-recognizer/whats-new.md

@@ -60,7 +60,7 @@ Form Recognizer service is updated on an ongoing basis. Bookmark this page to st
 
   The **prebuilt ID document model** now has added support for the following document types:
 
-  * Passport, driver's license, and residence permit ID expansion.
+  * Passport, driver's license, and residence permit ID expansion
   * US military ID cards and documents
   * India ID cards and documents
   * Australia ID cards and documents

articles/azure-resource-manager/management/azure-subscription-service-limits.md

@@ -105,6 +105,18 @@ To learn more about limits on a more granular level, such as document size, quer
 
 [!INCLUDE [azure-cognitive-services-limits](../../../includes/azure-cognitive-services-limits.md)]
 
+## Azure Communications Gateway limits
+
+Some of the following default limits and quotas can be increased. To request a change, create a [change request](/azure/communications-gateway/request-changes.md) stating the limit you want to change.
+
+[!INCLUDE [communications-gateway-general-restrictions](../../communications-gateway/includes/communications-gateway-general-restrictions.md)]
+
+Azure Communications Gateway also has limits on the SIP signaling.
+
+[!INCLUDE [communications-gateway-sip-size-restrictions](../../communications-gateway/includes/communications-gateway-sip-size-restrictions.md)]
+
+[!INCLUDE [communications-gateway-sip-behavior-restrictions](../../communications-gateway/includes/communications-gateway-sip-behavior-restrictions.md)]
+
 ## Azure Container Apps limits
 
 For Azure Container Apps limits, see [Quotas in Azure Container Apps](../../container-apps/quotas.md).

articles/cognitive-services/openai/how-to/completions.md

@@ -15,7 +15,7 @@ keywords:
 
 ---
 
-# Learn how to generate or manipulate text, including code
+# Learn how to generate or manipulate text
 
 The completions endpoint can be used for a wide variety of tasks. It provides a simple but powerful text-in, text-out interface to any of our [models](../concepts/models.md). You input some text as a prompt, and the model will generate a text completion that attempts to match whatever context or pattern you gave it. For example, if you give the API the prompt, "As Descartes said, I think, therefore", it will return the completion " I am" with high probability.
 
@@ -352,295 +352,13 @@ A: Two, Phobos and Deimos.
 
 Q:
 ```
-
 ## Working with code
 
 The Codex model series is a descendant of OpenAI's base GPT-3 series that's been trained on both natural language and billions of lines of code. It's most capable in Python and proficient in over a dozen languages including C#, JavaScript, Go, Perl, PHP, Ruby, Swift, TypeScript, SQL, and even Shell. 
 
-You can use Codex for a variety of tasks including:
-
- * Turn comments into code
- * Complete your next line or function in context
- * Bring knowledge to you, such as finding a useful library or API call for an application
- * Add comments
- * Rewrite code for efficiency
-
-
-### Codex examples
-
-Here are a few examples of using Codex
-
-**Saying "Hello" (Python)**
-
-```
-"""
-Ask the user for their name and say "Hello"
-"""
-```
-
-**Create random names (Python)**
-
-```
-"""
-1. Create a list of first names
-2. Create a list of last names
-3. Combine them randomly into a list of 100 full names
-"""
-```
-
-**Create a MySQL query (Python)**
-
-```
-"""
-Table customers, columns = [CustomerId, FirstName, LastName, Company, Address, City, State, Country, PostalCode, Phone, Fax, Email, SupportRepId]
-Create a MySQL query for all customers in Texas named Jane
-"""
-query = 
-```
-
-**Explaining code (JavaScript)**
-
-```
-// Function 1
-var fullNames = [];
-for (var i = 0; i < 50; i++) {
-  fullNames.push(names[Math.floor(Math.random() * names.length)]
-    + " " + lastNames[Math.floor(Math.random() * lastNames.length)]);
-}
-
-// What does Function 1 do?
-```
-
-### Best practices
-
-**Start with a comment, data or code.**  To get Codex to create a useful completion it's helpful to think about what information a programmer would need to perform a task. This could just be a clear comment or the data needed to write a useful function, like the names of variables or what class a function handles.
-
-```
-# Create a function called 'nameImporter' to add a first and last name to the database
-```
-
-In this example we tell Codex what to call the function and what task it's going to perform.
-
-This approach scales even to the point where you can provide Codex with a comment and an example of a database schema to get it to write useful query requests for various databases.
-
-```
-# Table albums, columns = [AlbumId, Title, ArtistId]
-# Table artists, columns = [ArtistId, Name]
-# Table media_types, columns = [MediaTypeId, Name]
-# Table playlists, columns = [PlaylistId, Name]
-# Table playlist_track, columns = [PlaylistId, TrackId]
-# Table tracks, columns = [TrackId, Name, AlbumId, MediaTypeId, GenreId, Composer, Milliseconds, Bytes, UnitPrice]
-
-# Create a query for all albums by Adele
-```
-
-When you show Codex the database schema it's able to make an informed guess about how to format a query.
-
-**Specify the language.** Codex understands dozens of different programming languages. Many share similar conventions for comments, functions and other programming syntax. By specifying the language and what version in a comment, Codex is better able to provide a completion for what you want. That said, Codex is fairly flexible with style and syntax.
-
-```
-# R language
-# Calculate the mean distance between an array of points
-```
-
-```
-# Python 3
-# Calculate the mean distance between an array of points
-```
-
-*Prompt Codex with what you want it to do.* If you want Codex to create a webpage, placing the first line of code in an HTML document (`<!DOCTYPE html>`) after your comment tells Codex what it should do next. The same method works for creating a function from a comment (following the comment with a new line starting with `func` or `def`).
-
-```
-<!-- Create a web page with the title 'Kat Katman attorney at paw' -->
-<!DOCTYPE html>
-```
-
-Placing `<!DOCTYPE html>` after our comment makes it very clear to Codex what we want it to do.
-
-```
-# Create a function to count to 100
-
-def counter
-```
-
-If we start writing the function Codex will understand what it needs to do next.
-
-**Specifying libraries will help Codex understand what you want.** Codex is aware of a large number of libraries, APIs and modules. By telling Codex which ones to use, either from a comment or importing them into your code, Codex will make suggestions based upon them instead of alternatives.
-
-```
-<!-- Use A-Frame version 1.2.0 to create a 3D website -->
-<!-- https://aframe.io/releases/1.2.0/aframe.min.js -->
-```
-
-By specifying the version, you can make sure Codex uses the most current library.
-
-> [!NOTE]
-> Codex can suggest helpful libraries and APIs, but always be sure to do your own research to make sure that they're safe for your application.
-
-**Comment style can affect code quality.** With some languages, the style of comments can improve the quality of the output. For example, when working with Python, in some cases using doc strings (comments wrapped in triple quotes) can give higher quality results than using the pound (#) symbol.
-
-```
-"""
-Create an array of users and email addresses
-"""
-```
-
-**Put comments inside of functions can be helpful.** Recommended coding standards suggest placing the description of a function inside the function. Using this format helps Codex more clearly understand what you want the function to do.
-
-```
-def getUserBalance(id):
-    """
-    Look up the user in the database ‘UserData' and return their current account balance.
-    """
-```
-
-**Provide examples for more precise results.** If you have a particular style or format you need Codex to use, providing examples or demonstrating it in the first part of the request will help Codex more accurately match what you need.
-
-```
-"""
-Create a list of random animals and species
-"""
-animals  = [ {"name": "Chomper", "species": "Hamster"}, {"name":
-```
-
-**Lower temperatures give more precise results.** Setting the API temperature to 0, or close to zero (such as 0.1 or 0.2) tends to give better results in most cases. Unlike GPT-3 models, where a higher temperature can provide useful creative and random results, higher temperatures with Codex models may give you really random or erratic responses.
-
-In cases where you need Codex to provide different potential results, start at zero and then increment upwards by .1 until you find suitable variation.
-
-**Organize tasks into functions.** We can get Codex to write functions by specifying what the function should do in as precise terms as possible in comment. By writing the following comment, Codex creates a JavaScript timer function that's triggered when a user presses a button:
-
-A simple JavaScript timer
-
-```
-// Create a timer that creates an alert in 10 seconds
-```
-
-We can use Codex to perform common tasks with well known libraries like creating a customer with the Stripe API:
-
-Create a Stripe customer in Python
-
-```
-# Create a Stripe customer from an email address
-```
-
-**Creating example data.** Testing applications often requires using example data. Because Codex is also a language model that understands how to comprehend and write natural language, you can ask Codex to create data like arrays of made up names, products and other variables.
-
-```
-/* Create an array of weather temperatures for San Francisco */
-```
-
-Asking Codex to perform this task will produce a table like this:
-
-```
-var weather = [
-  { month: 'January', high: 58, low: 48 },
-  { month: 'February', high: 61, low: 50 },
-  { month: 'March', high: 64, low: 53 },
-  { month: 'April', high: 67, low: 55 },
-  { month: 'May', high: 70, low: 58 },
-  { month: 'June', high: 73, low: 61 },
-  { month: 'July', high: 76, low: 63 },
-  { month: 'August', high: 77, low: 64 },
-  { month: 'September', high: 76, low: 63 },
-  { month: 'October', high: 73, low: 61 },
-  { month: 'November', high: 68, low: 57 },
-  { month: 'December', high: 64, low: 54 }
-];
-```
-
-**Compound functions and small applications.** We can provide Codex with a comment consisting of a complex request like creating a random name generator or performing tasks with user input and Codex can generate the rest provided there are enough tokens.
-
-```
-/*
-Create a list animals
-Create a list of cities
-Use the lists to generate stories about what I saw at the zoo in each city
-*/
-```
-
-**Use Codex to explain code.** Codex's ability to create and understand code allows us to use it to perform tasks like explaining what the code in a file does. One way to accomplish this is by putting a comment after a function that starts with "This function" or "This application is."  Codex typically interprets this comment as the start of an explanation and completes the rest of the text.
-
-```
-/* Explain what the previous function is doing: It
-```
-
-**Explaining an SQL query.** In this example we use Codex to explain in a human readable format what an SQL query is doing.
-
-```
-SELECT DISTINCT department.name
-FROM department
-JOIN employee ON department.id = employee.department_id
-JOIN salary_payments ON employee.id = salary_payments.employee_id
-WHERE salary_payments.date BETWEEN '2020-06-01' AND '2020-06-30'
-GROUP BY department.name
-HAVING COUNT(employee.id) > 10;
--- Explanation of the above query in human readable format
---
-```
-
-**Writing unit tests.** Creating a unit test can be accomplished in Python simply by adding the comment "Unit test" and starting a function.
-
-```
-# Python 3
-def sum_numbers(a, b):
-  return a + b
-
-# Unit test
-def
-```
-
-**Checking code for errors.** By using examples, you can show Codex how to identify errors in code. In some cases no examples are required, however demonstrating the level and detail to provide a description can help Codex understand what to look for and how to explain it. (A check by Codex for errors shouldn't replace careful review by the user. )
-
-```
-/* Explain why the previous function doesn't work. */
-```
-
-**Using source data to write database functions.** Just as a human programmer would benefit from understanding the database structure and the column names, Codex can use this data to help you write accurate query requests. In this example we insert the schema for a database and tell Codex what to query the database for.
-
-```
-# Table albums, columns = [AlbumId, Title, ArtistId]
-# Table artists, columns = [ArtistId, Name]
-# Table media_types, columns = [MediaTypeId, Name]
-# Table playlists, columns = [PlaylistId, Name]
-# Table playlist_track, columns = [PlaylistId, TrackId]
-# Table tracks, columns = [TrackId, Name, AlbumId, MediaTypeId, GenreId, Composer, Milliseconds, Bytes, UnitPrice]
-
-# Create a query for all albums by Adele
-```
-
-**Converting between languages.** You can get Codex to convert from one language to another by following a simple format where you list the language of the code you want to convert in a comment, followed by the code and then a comment with the language you want it translated into.
-
-```
-# Convert this from Python to R
-# Python version
-
-[ Python code ]
-
-# End
-
-# R version
-```
-
-**Rewriting code for a library or framework.** If you want Codex to make a function more efficient, you can provide it with the code to rewrite followed by an instruction on what format to use.
-
-```
-// Rewrite this as a React component
-var input = document.createElement('input');
-input.setAttribute('type', 'text');
-document.body.appendChild(input);
-var button = document.createElement('button');
-button.innerHTML = 'Say Hello';
-document.body.appendChild(button);
-button.onclick = function() {
-  var name = input.value;
-  var hello = document.createElement('div');
-  hello.innerHTML = 'Hello ' + name;
-  document.body.appendChild(hello);
-};
-
-// React version:
-```
+Learn more about generating code completions, with the [working with code guide](./work-with-code.md)
 
 ## Next steps
 
+Learn [how to work with code (Codex)](./work-with-code.md).
 Learn more about the [underlying models that power Azure OpenAI](../concepts/models.md).