@azure-tools/typespec-azure-core 0.30.0-dev.18 → 0.30.0-dev.19

package/lib/azure-core.tsp

@@ -14,6 +14,9 @@ using TypeSpec.Versioning;
 @versioned(Versions)
 namespace Azure.Core;
 
+/**
+ * Supported versions of Azure.Core TypeSpec building blocks.
+ */
 enum Versions {
   v1_0_Preview_1: "1.0-preview.1",
   v1_0_Preview_2: "1.0-preview.2",

package/lib/foundations.tsp

@@ -11,6 +11,9 @@ using Azure.Core.Traits.Private;
 
 namespace Azure.Core.Foundations;
 
+/**
+ * Enum describing allowed operation states.
+ */
 @lroStatus
 enum OperationState {
   InProgress,
@@ -19,6 +22,11 @@ enum OperationState {
   Canceled,
 }
 
+/**
+ * Provides status details for long running operations.
+ * @template TStatusResult The type of the operation status result.
+ * @template TStatusError The type of the operation status error. If not provided, the default error is used.
+ */
 @doc("Provides status details for long running operations.")
 model OperationStatus<TStatusResult = never, TStatusError = Foundations.Error> {
   @key("operationId")
@@ -35,6 +43,10 @@ model OperationStatus<TStatusResult = never, TStatusError = Foundations.Error> {
   result?: TStatusResult;
 }
 
+/**
+ * Conveys the resource instance to an operation as a request body.
+ * @template T The type of the resource instance.
+ */
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @doc("Conveys the resource instance to an operation as a request body.")
 model ResourceBody<T> {
@@ -52,12 +64,20 @@ alias ResourceOkResponse<T> = TypeSpec.Http.Response<200> & T;
 
 alias ResourceCreatedOrOkResponse<T extends object> = ResourceCreatedResponse<T> | ResourceOkResponse<T>;
 
+/**
+ * Response describing the location of a created resource.
+ * @template T The type of the created resource.
+ */
 model LocationOfCreatedResourceResponse<T extends object> is TypeSpec.Http.CreatedResponse {
   @finalLocation
   @TypeSpec.Http.header("Location")
   location: ResourceLocation<T>;
 }
 
+/**
+ * Response describing the location of a resource created with a service-provided name.
+ * @template T The type of the created resource.
+ */
 model LocationOfCreatedResourceWithServiceProvidedNameResponse<T extends object>
   is TypeSpec.Http.AcceptedResponse {
   @finalLocation
@@ -65,6 +85,10 @@ model LocationOfCreatedResourceWithServiceProvidedNameResponse<T extends object>
   location: ResourceLocation<T>;
 }
 
+/**
+ * Metadata for long running operation status monitor locations.
+ * @template TStatusResult The type of the operation status result.
+ */
 @doc("Metadata for long running operation status monitor locations")
 model LongRunningStatusLocation<TStatusResult = never> {
   @pollingLocation
@@ -75,6 +99,10 @@ model LongRunningStatusLocation<TStatusResult = never> {
 
 alias AcceptedResponse<T = {}> = TypeSpec.Http.AcceptedResponse & T;
 
+/**
+ * A response containing error details.
+ * @template TError The type of the error object.
+ */
 @error
 @doc("A response containing error details.")
 model ErrorResponseBase<TError> {
@@ -132,35 +160,72 @@ model InnerError {
   innererror?: InnerError;
 }
 
+/**
+ * Version of a model for a create or replace operation which only includes updateable properties.
+ * @template TResource The type of the resource.
+ */
 @omitKeyProperties
 model ResourceCreateOrReplaceModel<TResource extends object>
   is UpdateableProperties<DefaultKeyVisibility<TResource, "read">>;
 
+/**
+ * Collection of properties from a resource that are visible to create or update scopes.
+ * @template TResource The type of the resource.
+ */
 @withVisibility("create", "update")
 model CreateableAndUpdateableProperties<TResource> {
   ...TResource;
 }
 
+/**
+ * Version of a model for a create or update operation which only includes updateable properties.
+ * @template TResource The type of the resource.
+ */
 @omitKeyProperties
 model ResourceCreateOrUpdateModel<TResource>
   is OptionalProperties<CreateableAndUpdateableProperties<DefaultKeyVisibility<TResource, "read">>>;
 
+/**
+ * Version of a model for an update operation which only includes updateable properties.
+ * @template TResource The type of the resource.
+ */
 @omitKeyProperties
 model ResourceUpdateModel<TResource>
   is OptionalProperties<UpdateableProperties<DefaultKeyVisibility<TResource, "read">>>;
 
+/**
+ * A model containing the keys of the provided resource.
+ * @template TResource The type of the resource.
+ */
 @copyResourceKeyParameters
 model ItemKeysOf<TResource> {}
 
+/**
+ * A model containing the collection keys of the provided resource's parent resource.
+ * @template TResource The type of the resource.
+ */
 @copyResourceKeyParameters("parent")
 model CollectionKeysOf<TResource> {}
 
+/**
+ * A model describing a set of custom request parameters.
+ * @template TCustom An object describing custom request parameters.
+ */
 @Private.spreadCustomParameters(TCustom)
 model CustomParameters<TCustom extends object> {}
 
+/**
+ * A model describing a set of custom response properties.
+ * @template TCustom An object describing custom response properties.
+ */
 @Private.spreadCustomResponseProperties(TCustom)
 model CustomResponseFields<TCustom extends object> {}
 
+/**
+ * A model describing a customized page of resources.
+ * @template TResource The type of the resource.
+ * @template Traits Traits which apply to the page.
+ */
 @pagedResult
 @doc("Paged collection of {name} items", TResource)
 model CustomPage<TResource extends object, Traits extends object = {}> {
@@ -175,6 +240,9 @@ model CustomPage<TResource extends object, Traits extends object = {}> {
   ...TraitProperties<Traits, TraitLocation.Response, TraitContext.List>;
 }
 
+/**
+ * The expected shape of model types passed to the TCustom parameter of operation signatures.
+ */
 @doc("The expected shape of model types passed to the TCustom parameter of operation signatures.")
 model CustomizationFields {
   @doc("An object containing custom parameters that will be included in the operation.")
@@ -186,6 +254,13 @@ model CustomizationFields {
 
 // Basic Operation Shapes
 
+/**
+ * The most basic operation.
+ * @template TParams Object describing the request parameters of the operation.
+ * @template TResponse Object describing the response properties of the operation.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 #suppress "@azure-tools/typespec-providerhub/operation-requires-documentation" "This is a library operation."
 op Operation<
   TParams,
@@ -200,6 +275,13 @@ op Operation<
   ...TParams
 ): TResponse | TErrorResponse;
 
+/**
+ * Long-running operation.
+ * @template TParams Object describing the request parameters of the operation.
+ * @template TResponse Object describing the response properties of the operation. If not provided, the AcceptedResponse type will be used.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 #suppress "@azure-tools/typespec-providerhub/no-inline-model" "This operation signature is not used in Azure Resource Manager operations (yet)"
 op LongRunningOperation<
   TParams,
@@ -208,6 +290,14 @@ op LongRunningOperation<
   TErrorResponse = Azure.Core.Foundations.ErrorResponse
 > is Operation<TParams, TResponse & Foundations.LongRunningStatusLocation, Traits, TErrorResponse>;
 
+/**
+ * Operation that returns the status of another operation.
+ * @template TParams Object describing the request parameters of the operation.
+ * @template TStatusResult The type of the operation status result.
+ * @template TStatusError The type of the operation status error.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 op GetOperationStatus<
   TParams = {},
   TStatusResult = never,
@@ -227,6 +317,14 @@ op GetOperationStatus<
 
 // Fundamental Resource Operation Shapes
 
+/**
+ * The most basic operation that applies to a resource.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters of the operation.
+ * @template TResponse Object describing the response properties of the operation.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "This operation must return a status monitor in its response."
 @autoRoute
 @Private.ensureResourceType(TResource)
@@ -238,6 +336,14 @@ op ResourceOperation<
   TErrorResponse = Azure.Core.Foundations.ErrorResponse
 > is Operation<Foundations.ItemKeysOf<TResource> & TParams, TResponse, Traits, TErrorResponse>;
 
+/**
+ * Operation that applies to a collection of resources.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters of the operation.
+ * @template TResponse Object describing the response properties of the operation.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 #suppress "@azure-tools/typespec-azure-resource-manager/no-response-body" "This operation must return a status monitor in its response."
 @autoRoute
 @Private.ensureResourceType(TResource)
@@ -254,6 +360,14 @@ op ResourceCollectionOperation<
   TErrorResponse
 >;
 
+/**
+ * Operation that lists resources in a paginated way.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters of the operation.
+ * @template TResponse Object describing the response properties of the operation.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 @listsResource(TResource)
 @Private.ensureResourceType(TResource)
 op ResourceList<
@@ -264,6 +378,12 @@ op ResourceList<
   TErrorResponse = Azure.Core.Foundations.ErrorResponse
 > is ResourceCollectionOperation<TResource, TParams, TResponse, Traits, TErrorResponse>;
 
+/**
+ * Operation that lists resources in a non-paginated way.
+ * @template TResource The type of the resource.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 #suppress "@azure-tools/typespec-providerhub/no-inline-model" "This operation signature is not used in Azure Resource Manager operations (yet)"
 @autoRoute
 op NonPagedResourceList<
@@ -278,6 +398,12 @@ op NonPagedResourceList<
   TErrorResponse
 >;
 
+/**
+ * Long-running operation that updates a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits which apply to the operation.
+ * @template TErrorResponse The type of the error response. If not provided, the default error response type will be used.
+ */
 @updatesResource(TResource)
 op LongRunningResourceUpdate<
   TResource extends object,

package/lib/models.tsp

@@ -7,6 +7,10 @@ using TypeSpec.Rest;
 
 namespace Azure.Core;
 
+/**
+ * Describes a page of resource object.
+ * @template TResource The resource type.
+ */
 @pagedResult
 @friendlyName("Paged{name}", TResource)
 @doc("Paged collection of {name} items", TResource)
@@ -20,12 +24,26 @@ model Page<TResource extends object> {
   nextLink?: ResourceLocation<TResource>;
 }
 
+/**
+ * Defines a property as a request parameter.
+ * @template T The parameter name.
+ */
 @Foundations.requestParameter(T)
 model RequestParameter<T extends string> {}
 
+/**
+ * Defines a property as a response header.
+ * @template T The header name.
+ */
 @Foundations.responseProperty(T)
 model ResponseProperty<T extends string> {}
 
+/**
+ * Provides the status of a resource operation.
+ * @template TResource The resource type.
+ * @template TStatusResult Model describing the status result object. If not specified, the default is the resource type.
+ * @template TStatusError Model describing the status error object. If not specified, the default is the Foundations.Error.
+ */
 @resource("operations")
 @parentResource(TResource)
 model ResourceOperationStatus<

package/lib/operations.tsp

@@ -14,6 +14,13 @@ using Azure.Core.Traits.Private;
 
 // RPC Operations
 
+/**
+ * A remote procedure call (RPC) operation.
+ * @template TParams Object describing the parameters of the operation.
+ * @template TResponse Object describing the response of the operation.
+ * @template Traits Object describing the traits of the operation.
+ * @template TErrorResponse Error response of the operation. If not specified, the default error response is used.
+ */
 @Foundations.Private.needsRoute
 op RpcOperation<
   TParams,
@@ -39,6 +46,11 @@ alias ExpectedResourceOperationTraits = [
   }
 ];
 
+/**
+ * Interface containing common resource operations.
+ * @template InterfaceTraits Traits applicable to the operations.
+ * @template TErrorResponse Error response of the operations. If not specified, the default error response is used.
+ */
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @ensureTraitsPresent(InterfaceTraits, ExpectedResourceOperationTraits)
 interface ResourceOperations<
@@ -343,73 +355,134 @@ alias StandardResourceOperations = ResourceOperations<NoConditionalRequests &
   NoRepeatableRequests &
   NoClientRequestId>;
 
+/**
+ * Operation signature to create or replace a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceCreateOrReplace<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceCreateOrReplace<TResource, Traits>;
 
+/**
+ * Long-running operation signature to create or replace a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op LongRunningResourceCreateOrReplace<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.LongRunningResourceCreateOrReplace<TResource, Traits>;
 
+/**
+ * Operation signature to create or update a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceCreateOrUpdate<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceCreateOrUpdate<TResource, Traits>;
 
+/**
+ * Long-running operation signature to create or update a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op LongRunningResourceCreateOrUpdate<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.LongRunningResourceCreateOrUpdate<TResource, Traits>;
 
+/**
+ * Operation signature to update a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceUpdate<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceUpdate<TResource, Traits>;
 
+/**
+ * Long-running operation signature to create a resource with a service-provided name.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceCreateWithServiceProvidedName<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceCreateWithServiceProvidedName<TResource, Traits>;
 
+/**
+ * Long-running operation signature to create a resource with a service-provided name.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op LongRunningResourceCreateWithServiceProvidedName<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.LongRunningResourceCreateWithServiceProvidedName<TResource, Traits>;
 
+/**
+ * Long-running operation signature to retrieve a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceRead<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceRead<TResource, Traits>;
 
+/**
+ * Long-running operation signature to delete a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceDelete<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceDelete<TResource, Traits>;
 
+/**
+ * Long-running operation signature to delete a resource.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op LongRunningResourceDelete<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.LongRunningResourceDelete<TResource, Traits>;
 
+/**
+ * Operation signature to list resources in a paginated way.
+ * @template TResource The type of the resource.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceList<
   TResource extends object,
   Traits extends object = {}
 > is StandardResourceOperations.ResourceList<TResource, Traits>;
 
-// Custom Resource Action Operations
+/**
+ * Operation signature for a resource action.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters.
+ * @template TResponse Object describing the response parameters.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceAction<
   TResource extends object,
@@ -418,6 +491,13 @@ op ResourceAction<
   Traits extends object = {}
 > is StandardResourceOperations.ResourceAction<TResource, TParams, TResponse, Traits>;
 
+/**
+ * Operation signature for an action that applies to a collection of resources.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters.
+ * @template TResponse Object describing the response parameters.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op ResourceCollectionAction<
   TResource extends object,
@@ -426,6 +506,14 @@ op ResourceCollectionAction<
   Traits extends object = {}
 > is StandardResourceOperations.ResourceCollectionAction<TResource, TParams, TResponse, Traits>;
 
+/**
+ * Long-running operation signature for a resource action.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters.
+ * @template TStatusResult Object describing the result of the status operation.
+ * @template TStatusError Object describing the error of the status operation. If not provided, the default error type is used.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op LongRunningResourceAction<
   TResource extends object,
@@ -441,6 +529,14 @@ op LongRunningResourceAction<
   Traits
 >;
 
+/**
+ * Long-running operation signature for an action that applies to a collection of resources.
+ * @template TResource The type of the resource.
+ * @template TParams Object describing the request parameters.
+ * @template TStatusResult Object describing the result of the status operation.
+ * @template TStatusError Object describing the error of the status operation. If not provided, the default error type is used.
+ * @template Traits Traits to apply to the operation.
+ */
 @removed(Azure.Core.Versions.v1_0_Preview_2)
 op LongRunningResourceCollectionAction<
   TResource extends object,
@@ -458,6 +554,13 @@ op LongRunningResourceCollectionAction<
 
 // Resource Status Monitoring
 
+/**
+ * Operation signature to retrieve a resource operation status.
+ * @template TResource The type of the resource.
+ * @template TStatusResult Object describing the result of the status operation.
+ * @template TStatusError Object describing the error of the status operation. If not provided, the default error type is used.
+ * @template Traits Traits to apply to the operation.
+ */
 @readsResource(ResourceOperationStatus<TResource>)
 @Foundations.Private.ensureResourceType(TResource)
 op GetResourceOperationStatus<

package/lib/traits.tsp

@@ -5,6 +5,9 @@ namespace Azure.Core.Traits;
 using TypeSpec.Reflection;
 using TypeSpec.Versioning;
 
+/**
+ * Enumerates the standard trait locations for Azure.Core operations.
+ */
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @doc("Enumerates the standard trait locations for Azure.Core operations.")
 enum TraitLocation {
@@ -18,8 +21,11 @@ enum TraitLocation {
   ApiVersionParameter,
 }
 
+/**
+ * Enumerates the standard trait contexts for Azure.Core operations.
+ */
 @added(Azure.Core.Versions.v1_0_Preview_2)
-@doc("Enumerates the standard trait contexts for Azure.Core operations.")
+@doc("")
 enum TraitContext {
   @doc("Trait is applicable for resource 'read' operations.")
   Read,
@@ -40,10 +46,19 @@ enum TraitContext {
   Action,
 }
 
+/**
+ * Used to override a trait.
+ * @template Trait The trait to override.
+ */
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @Private.applyTraitOverride(Trait)
 model TraitOverride<Trait> {}
 
+/**
+ * Declares a trait that is applied as a query parameter.
+ * @template TParams The name of the query parameter.
+ * @template Contexts The contexts in which the trait is applicable.
+ */
 @trait
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @Private.ensureAllQueryParams(TParams)
@@ -55,10 +70,19 @@ model QueryParametersTrait<TParams, Contexts = unknown> {
   };
 }
 
+/**
+ * Declares a trait that is applied as a query parameter for list operations.
+ * @template TParams Object describing the query parameters.
+ */
 @trait
 @added(Azure.Core.Versions.v1_0_Preview_2)
 model ListQueryParametersTrait<TParams> is QueryParametersTrait<TParams, TraitContext.List>;
 
+/**
+ * Declares a trait that is applied as a request header parameter.
+ * @template THeaders Object describing the request header parameters.
+ * @template Contexts The contexts in which the trait is applicable.
+ */
 @trait
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @Private.ensureAllHeaderParams(THeaders)
@@ -70,6 +94,11 @@ model RequestHeadersTrait<THeaders, Contexts = unknown> {
   };
 }
 
+/**
+ * Declares a trait that is applied as a response header parameter.
+ * @template THeaders Object describing the response header parameters.
+ * @template Contexts The contexts in which the trait is applicable.
+ */
 @trait
 @added(Azure.Core.Versions.v1_0_Preview_2)
 @Private.ensureAllHeaderParams(THeaders)
@@ -81,6 +110,10 @@ model ResponseHeadersTrait<THeaders, Contexts = unknown> {
   };
 }
 
+/**
+ * Declares a version parameter trait.
+ * @template TVersionParameter The type of the version parameter.
+ */
 @trait("VersionParameter")
 @added(Azure.Core.Versions.v1_0_Preview_2)
 model VersionParameterTrait<TVersionParameter> {
@@ -186,7 +219,7 @@ extern dec trait(target: unknown, traitName?: string);
  * `@traitContext` sets the applicable context for a trait on its envelope property.
  *
  * @param target The trait envelope property where the context will be applied.
- * @param traitContext An enum member or union of enum members representing the trait's
+ * @param contexts An enum member or union of enum members representing the trait's
  *        applicable contexts.
  */
 extern dec traitContext(target: ModelProperty, contexts: EnumMember | Union | unknown);
@@ -195,7 +228,8 @@ extern dec traitContext(target: ModelProperty, contexts: EnumMember | Union | un
  * `@traitLocation` sets the applicable location for a trait on its envelope property.
  *
  * @param target The trait envelope property where the context will be applied.
- * @param traitLocation An enum member representing the trait's applicable location.
+ * @param contexts An enum member or union of enum members representing the trait's
+ *        applicable contexts.
  */
 extern dec traitLocation(target: ModelProperty, contexts: EnumMember);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-core",
-  "version": "0.30.0-dev.18",
+  "version": "0.30.0-dev.19",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Core library",
   "homepage": "https://azure.github.io/typespec-azure",