merge with master

Author: seaeunlee

.github/fabricbot.json

@@ -2362,7 +2362,6 @@
               "Search"
             ],
             "mentionees": [
-              "brjohnstmsft",
               "bleroy",
               "tjacobhi",
               "markheff",

CODEOWNERS

@@ -14,7 +14,7 @@
 /specification/schemaregistry/ @hmlam @nickghardwick @lmazuel @deyaaeldeen @JoshLove-msft @swathipil @conniey
 
 # PRLabel: %Cognitive Services
-/dev/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @kristapratico @mssfang @Azure/api-stewardship-board
+/dev/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @kristapratico @mssfang @joseharriaga @Azure/api-stewardship-board
 
 /specification/adp/ @Azure/adp
 
@@ -65,7 +65,7 @@
 /specification/cognitiveservices/ @felixwa @yangyuan
 
 # PRLabel: %Cognitive - Language
-/specification/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @kristapratico @mssfang @Azure/api-stewardship-board
+/specification/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @kristapratico @mssfang @joseharriaga @Azure/api-stewardship-board
 
 # PRLabel: %Compute
 /specification/compute/ @bilaakpan-ms @sandido @dkulkarni-ms @haagha @madewithsmiles @MS-syh2qs @grizzlytheodore @hyonholee @mabhard @danielli90 @smotwani @ppatwa @vikramd-ms @yunusm @ZhidongPeng @nkuchta @maheshnemichand @najams @changov
@@ -199,7 +199,7 @@
 /specification/scheduler/ @pinwang81
 
 # PRLabel: %Search
-/specification/search/data-plane/ @brjohnstmsft @arv100kri @bleroy @AlexGhiondea @Mohit-Chakraborty @Azure/api-stewardship-board
+/specification/search/data-plane/ @arv100kri @bleroy @AlexGhiondea @Mohit-Chakraborty @Azure/api-stewardship-board
 
 # PRLabel: %Search
 /specification/search/resource-manager/ @abhi1509 @tjacobhi

custom-words.txt

@@ -394,6 +394,8 @@ CMAF
 Cmdkey
 cmdlet
 cmdlets
+cmek
+Cmek
 CMKDW
 CMKHS
 CMMI
@@ -1380,6 +1382,7 @@ netbios
 netbsd
 netdev
 Netdev
+Netezza
 netfilter
 Netfilter
 networkinterfaces
@@ -2069,6 +2072,7 @@ subtree
 subtrees
 subvolume
 subvolumes
+subwoofer
 subword
 subwords
 suggesters

dev/cognitiveservices/data-plane/Language/examples/questionanswering/authoring/SuccessfulDeleteProject.json

@@ -7,6 +7,11 @@
     "projectName": "proj1"
   },
   "responses": {
-    "202": {}
+    "202": {
+      "description": "A successful call results with an Operation-Location header used to check the status of the analysis job.",
+      "headers": {
+        "Operation-Location": "https://<resource-endpoint>/language/authoring/query-knowledgebases/projects/deletion-jobs/job1?api-version=2023-05-01"
+      }
+    }
   }
 }

dev/cognitiveservices/data-plane/Language/examples/questionanswering/authoring/SuccessfulGetSources.json

@@ -15,14 +15,16 @@
             "displayName": "source1",
             "sourceUri": "https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/overview/overview",
             "sourceKind": "url",
-            "lastUpdatedDateTime": "2021-05-01T15:13:22Z"
+            "lastUpdatedDateTime": "2021-05-01T15:13:22Z",
+            "source": "https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/overview/overview"
           },
           {
             "displayName": "source2",
             "sourceUri": "https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf",
             "sourceKind": "file",
             "contentStructureKind": "unstructured",
-            "lastUpdatedDateTime": "2021-05-01T15:13:22Z"
+            "lastUpdatedDateTime": "2021-05-01T15:13:22Z",
+            "source": "surface-guide.pdf"
           }
         ]
       }

dev/cognitiveservices/data-plane/Language/examples/questionanswering/authoring/SuccessfulUpdateSources.json

@@ -11,7 +11,8 @@
         "value": {
           "displayName": "source3",
           "sourceUri": "https://docs.microsoft.com/en-us/azure/cognitive-services/cognitive-services-support-options?context=/azure/cognitive-services/qnamaker/context/context",
-          "sourceKind": "url"
+          "sourceKind": "url",
+          "source": "https://docs.microsoft.com/en-us/azure/cognitive-services/cognitive-services-support-options?context=/azure/cognitive-services/qnamaker/context/context"
         }
       },
       {
@@ -20,15 +21,17 @@
           "displayName": "source1",
           "sourceUri": "https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/overview/overview",
           "sourceKind": "url",
-          "refresh": true
+          "refresh": true,
+          "source": "https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/overview/overview"
         }
       },
       {
         "op": "delete",
         "value": {
           "displayName": "source2",
           "sourceUri": "https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf",
-          "sourceKind": "file"
+          "sourceKind": "file",
+          "source": "surface-guide.pdf"
         }
       }
     ]

dev/cognitiveservices/data-plane/Language/questionanswering-authoring.json

@@ -1650,7 +1650,8 @@
       "additionalProperties": false,
       "required": [
         "sourceUri",
-        "sourceKind"
+        "sourceKind",
+        "source"
       ],
       "properties": {
         "displayName": {

documentation/api-scenario/how-to/MakeTestProxyRecording.md

@@ -0,0 +1,87 @@
+# How to use API Scenario Test and test-proxy to make traffic recording
+
+In this section, we'll show you how to make traffic recording with API Scenario Test and test-proxy, assuming you've already learnt how to use API Scenario test. If not, please go to [QuickStart](./QuickStart.md).
+
+Test-proxy is a tool that provides out-of-process record/playback capabilities compatible with any language. It also supports pushing/restoring the API test recordings from external git repository. Traffic recording can be an evidence of running API test, and also help validate Swagger consistency. See [how to install test-proxy](https://github.com/Azure/azure-sdk-tools/blob/main/tools/test-proxy/Azure.Sdk.Tools.TestProxy/README.md#installation)
+
+## Prepare assets.json file
+
+The assets.json file is a configuration file used by test-proxy to push/restore recording to/from external git repository. Create an assets.json file under `scenarios/` folder with following content:
+
+```json
+{
+  "AssetsRepo": "Azure/azure-sdk-assets",
+  "AssetsRepoPrefixPath": "",
+  "TagPrefix": "apitest/<ServiceName>/<package>"
+}
+```
+
+Take appConfiguration as an example,
+
+```
+specification/appconfiguration/data-plane
+├── Microsoft.AppConfiguration
+│   └── stable
+│       └── 1.0
+│           ├── appconfiguration.json
+│           ├── examples
+│           │   ├── CheckKeyValue.json
+│           │   ├── PutLock.json
+│           │   └── PutLock_IfMatch.json
+│           └── scenarios
+│               └── assets.json         <----- check-in assets.json here
+└── readme.md
+```
+
+## Make recording
+
+1. Start test-proxy under the repository root folder
+
+```bash
+test-proxy start
+```
+
+By default, it listens to 5000/5001 ports for http/https respectively.
+
+2. Run API Scenario test
+
+```bash
+oav run <your-scenario-file>.yaml -e <your-env>.json --testProxy http://localhost:5000 --testProxyAssets <your-assets-file>.json
+```
+
+3. Check the recording file
+
+The recording file can be found in the `<repository-root>/.assets` folder.
+
+## Push recording
+
+1. Delete secrets from recording files
+
+Please ensure no secrets in the recording file, before trying to push to external git repository.
+
+2. Push recording to the git repository
+
+```bash
+test-proxy push -a <your-assets-file>.json
+```
+
+3. Commit updated assets.json file
+
+After pushing the recording, test-proxy will write the latest git tag to assets.json file. Check the content of recording on github assets repository if as expected. If no problem, commit and push the updated assets.json file.
+
+## Restore recording
+
+Use following command to fetch recording:
+
+```bash
+test-proxy restore -a <your-assets-file>.json
+```
+
+or reset if any weird thing happens:
+
+```bash
+test-proxy reset -a <your-assets-file>.json
+```
+## Playback recording
+
+TBA

documentation/api-scenario/readme.md

@@ -17,6 +17,7 @@ API Scenario is a YAML file defining RESTful API usage scenarios of your service
 - [Example: Write and run your first API scenario file](./how-to/QuickStart.md)
 - [Example: Generate a basic API scenario file](./how-to/GenerateABasicApiScenario.md)
 - [Example: Resolve external dependencies](./how-to/ResolveDependencies.md)
+- [Example: Make traffic recording with test-proxy](./how-to/MakeTestProxyRecording.md)
 - [API scenario file sample](../samplefiles/Microsoft.YourServiceName/stable/YYYY-MM-DD/scenarios/quickStart.yaml)
 
 ## References

documentation/cadl-sample-project/specification/contosowidgetmanager/Contoso.WidgetManager.Shared/main.cadl

@@ -0,0 +1,8 @@
+@doc("Faked shared model")
+model FakedSharedModel {
+  @doc("The tag.")
+  tag: string;
+
+  @doc("The created date.")
+  createdDate: zonedDateTime;
+}