Azure · azabbasi · Aug 18, 2020 · Aug 18, 2020 · Aug 18, 2020 · Aug 18, 2020
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/autorest.md b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/autorest.md
@@ -2,15 +2,16 @@
 
 Run `generate.ps1` in this directory to generate the code.
 
-### AutoRest Configuration
-> see https://aka.ms/autorest
+## AutoRest Configuration
 
-``` yaml
-#when generating from local changes:
-input-file: $(this-folder)/swagger/digitaltwins.json
+> see <https://aka.ms/autorest>
 
+``` yaml
 #when generating from official source
-#require: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/c3dd5df2863101b56eef256b810927cdcc4e44d2/specification/digitaltwins/data-plane/readme.md
+input-file: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/specification/digitaltwins/data-plane/Microsoft.DigitalTwins/preview/2020-05-31-preview/digitaltwins.json
+
+#if you want to generate using local changes:
+#input-file: $(this-folder)/swagger/2020-05-31-preview/digitaltwins.json
 
 #azure-arm: true
 #license-header: MICROSOFT_MIT_NO_VERSION

diff --git a/...lTwins.Core/src/swagger/digitaltwins.json → ...gger/2020-05-31-preview/digitaltwins.json b/...lTwins.Core/src/swagger/digitaltwins.json → ...gger/2020-05-31-preview/digitaltwins.json
diff --git a/...es/CreateRelationshipAdvancedExample.json → ...es/CreateRelationshipAdvancedExample.json b/...es/CreateRelationshipAdvancedExample.json → ...es/CreateRelationshipAdvancedExample.json
diff --git a/...mples/CreateRelationshipBasicExample.json → ...mples/CreateRelationshipBasicExample.json b/...mples/CreateRelationshipBasicExample.json → ...mples/CreateRelationshipBasicExample.json
diff --git a/...ore/src/swagger/examples/DeleteModel.json → ...0-05-31-preview/examples/DeleteModel.json b/...ore/src/swagger/examples/DeleteModel.json → ...0-05-31-preview/examples/DeleteModel.json
diff --git a/.../swagger/examples/DeleteRelationship.json → ...-preview/examples/DeleteRelationship.json b/.../swagger/examples/DeleteRelationship.json → ...-preview/examples/DeleteRelationship.json
diff --git a/...Core/src/swagger/examples/DeleteTwin.json → ...20-05-31-preview/examples/DeleteTwin.json b/...Core/src/swagger/examples/DeleteTwin.json → ...20-05-31-preview/examples/DeleteTwin.json
diff --git a/...rc/swagger/examples/EventRouteDelete.json → ...31-preview/examples/EventRouteDelete.json b/...rc/swagger/examples/EventRouteDelete.json → ...31-preview/examples/EventRouteDelete.json
diff --git a/...e/src/swagger/examples/EventRouteGet.json → ...05-31-preview/examples/EventRouteGet.json b/...e/src/swagger/examples/EventRouteGet.json → ...05-31-preview/examples/EventRouteGet.json
diff --git a/...e/src/swagger/examples/EventRoutePut.json → ...05-31-preview/examples/EventRoutePut.json b/...e/src/swagger/examples/EventRoutePut.json → ...05-31-preview/examples/EventRoutePut.json
diff --git a/...ger/examples/EventRoutePutWithFilter.json → ...iew/examples/EventRoutePutWithFilter.json b/...ger/examples/EventRoutePutWithFilter.json → ...iew/examples/EventRoutePutWithFilter.json
diff --git a/...src/swagger/examples/EventRoutesList.json → ...-31-preview/examples/EventRoutesList.json b/...src/swagger/examples/EventRoutesList.json → ...-31-preview/examples/EventRoutesList.json
diff --git a/...re/src/swagger/examples/GetComponent.json → ...-05-31-preview/examples/GetComponent.json b/...re/src/swagger/examples/GetComponent.json → ...-05-31-preview/examples/GetComponent.json
diff --git a/...ger/examples/GetIncomingRelationship.json → ...iew/examples/GetIncomingRelationship.json b/...ger/examples/GetIncomingRelationship.json → ...iew/examples/GetIncomingRelationship.json
diff --git a/...src/swagger/examples/GetRelationship.json → ...-31-preview/examples/GetRelationship.json b/...src/swagger/examples/GetRelationship.json → ...-31-preview/examples/GetRelationship.json
diff --git a/...swagger/examples/GetRelationshipById.json → ...preview/examples/GetRelationshipById.json b/...swagger/examples/GetRelationshipById.json → ...preview/examples/GetRelationshipById.json
diff --git a/...es/GetRelationshipByRelationshipName.json → ...es/GetRelationshipByRelationshipName.json b/...es/GetRelationshipByRelationshipName.json → ...es/GetRelationshipByRelationshipName.json
diff --git a/...ns.Core/src/swagger/examples/GetTwin.json → .../2020-05-31-preview/examples/GetTwin.json b/...ns.Core/src/swagger/examples/GetTwin.json → .../2020-05-31-preview/examples/GetTwin.json
diff --git a/...s.Core/src/swagger/examples/ModelAdd.json → ...2020-05-31-preview/examples/ModelAdd.json b/...s.Core/src/swagger/examples/ModelAdd.json → ...2020-05-31-preview/examples/ModelAdd.json
diff --git a/...re/src/swagger/examples/ModelGetById.json → ...-05-31-preview/examples/ModelGetById.json b/...re/src/swagger/examples/ModelGetById.json → ...-05-31-preview/examples/ModelGetById.json
diff --git a/...delGetByIdWithIncludeModelDefinition.json → ...delGetByIdWithIncludeModelDefinition.json b/...delGetByIdWithIncludeModelDefinition.json → ...delGetByIdWithIncludeModelDefinition.json
diff --git a/...r/examples/ModelUpdateDecommissioned.json → ...w/examples/ModelUpdateDecommissioned.json b/...r/examples/ModelUpdateDecommissioned.json → ...w/examples/ModelUpdateDecommissioned.json
diff --git a/....Core/src/swagger/examples/ModelsGet.json → ...020-05-31-preview/examples/ModelsGet.json b/....Core/src/swagger/examples/ModelsGet.json → ...020-05-31-preview/examples/ModelsGet.json
diff --git a/...ependenciesAndIncludeModelDefinition.json → ...ependenciesAndIncludeModelDefinition.json b/...ependenciesAndIncludeModelDefinition.json → ...ependenciesAndIncludeModelDefinition.json
diff --git a/...amples/PatchComponentAdvancedExample.json → ...amples/PatchComponentAdvancedExample.json b/...amples/PatchComponentAdvancedExample.json → ...amples/PatchComponentAdvancedExample.json
diff --git a/.../examples/PatchComponentBasicExample.json → .../examples/PatchComponentBasicExample.json b/.../examples/PatchComponentBasicExample.json → .../examples/PatchComponentBasicExample.json
diff --git a/...les/PatchRelationshipAdvancedExample.json → ...les/PatchRelationshipAdvancedExample.json b/...les/PatchRelationshipAdvancedExample.json → ...les/PatchRelationshipAdvancedExample.json
diff --git a/...amples/PatchRelationshipBasicExample.json → ...amples/PatchRelationshipBasicExample.json b/...amples/PatchRelationshipBasicExample.json → ...amples/PatchRelationshipBasicExample.json
diff --git a/...er/examples/PatchTwinAdvancedExample.json → ...ew/examples/PatchTwinAdvancedExample.json b/...er/examples/PatchTwinAdvancedExample.json → ...ew/examples/PatchTwinAdvancedExample.json
diff --git a/...agger/examples/PatchTwinBasicExample.json → ...eview/examples/PatchTwinBasicExample.json b/...agger/examples/PatchTwinBasicExample.json → ...eview/examples/PatchTwinBasicExample.json
diff --git a/...gger/examples/PutTwinAdvancedExample.json → ...view/examples/PutTwinAdvancedExample.json b/...gger/examples/PutTwinAdvancedExample.json → ...view/examples/PutTwinAdvancedExample.json
diff --git a/...swagger/examples/PutTwinBasicExample.json → ...preview/examples/PutTwinBasicExample.json b/...swagger/examples/PutTwinBasicExample.json → ...preview/examples/PutTwinBasicExample.json
diff --git a/.../src/swagger/examples/QueryFirstPage.json → ...5-31-preview/examples/QueryFirstPage.json b/.../src/swagger/examples/QueryFirstPage.json → ...5-31-preview/examples/QueryFirstPage.json
diff --git a/....Core/src/swagger/examples/QueryJoin.json → ...020-05-31-preview/examples/QueryJoin.json b/....Core/src/swagger/examples/QueryJoin.json → ...020-05-31-preview/examples/QueryJoin.json
diff --git a/...e/src/swagger/examples/QueryNextPage.json → ...05-31-preview/examples/QueryNextPage.json b/...e/src/swagger/examples/QueryNextPage.json → ...05-31-preview/examples/QueryNextPage.json
diff --git a/...e/src/swagger/examples/SendTelemetry.json → ...05-31-preview/examples/SendTelemetry.json b/...e/src/swagger/examples/SendTelemetry.json → ...05-31-preview/examples/SendTelemetry.json
diff --git a/.../examples/SendTelemetryFromComponent.json → .../examples/SendTelemetryFromComponent.json b/.../examples/SendTelemetryFromComponent.json → .../examples/SendTelemetryFromComponent.json
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/swagger/README.md b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/swagger/README.md
@@ -0,0 +1,9 @@
+# Azure DigitalTwins swagger
+
+## Local copy of the swagger document
+
+A local copy of the official swagger documents are stored in this directory for convenience and testing purposes. Please make sure that you do not use these swagger documents for official code generation purposes.
+
+## Official swagger document
+
+The official swagger specification for Azure DigitalTwins can be found [here](https://github.com/Azure/azure-rest-api-specs/tree/master/specification/digitaltwins/data-plane/Microsoft.DigitalTwins).