From 4225733ec94588132c9ed3bbacd7f842a74fab14 Mon Sep 17 00:00:00 2001 From: Mingzhe Huang Date: Wed, 18 Dec 2024 12:54:09 +0800 Subject: [PATCH] refactor(http-client-csharp): dump deprecated `description` properties (#5154) - emitter: replace all `description` properties of input types with `summary` and `doc` - generator: - update json converters for the emitter schema change - only expose `Summary` and `Doc` properties if they are used by other classes - update test cases accordingly part of #4771 --------- Co-authored-by: Mingzhe Huang (from Dev Box) Co-authored-by: Chenjie Shi Co-authored-by: Weidong Xu Co-authored-by: Wei Hu Co-authored-by: Pan Shao <97225342+pshao25@users.noreply.github.com> Co-authored-by: Pan Shao Co-authored-by: Christopher Radek <14189820+chrisradek@users.noreply.github.com> Co-authored-by: Christopher Radek Co-authored-by: iscai-msft <43154838+iscai-msft@users.noreply.github.com> Co-authored-by: iscai-msft Co-authored-by: Jorge Rangel <102122018+jorgerangel-msft@users.noreply.github.com> Co-authored-by: Jesse Squire Co-authored-by: Allen Zhang Co-authored-by: Mike Harder Co-authored-by: Will Temple Co-authored-by: Will Temple Co-authored-by: JoshLove-msft <54595583+JoshLove-msft@users.noreply.github.com> Co-authored-by: Xiaofei Cao <92354331+XiaofeiCao@users.noreply.github.com> Co-authored-by: Sarangan Rajamanickam Co-authored-by: Adam O'Brien Co-authored-by: Mark Cowlishaw Co-authored-by: Yuchao Yan Co-authored-by: mcgallan <88413158+mcgallan@users.noreply.github.com> Co-authored-by: msyyc <70930885+msyyc@users.noreply.github.com> Co-authored-by: Tomer Aberbach Co-authored-by: Rodge Fu Co-authored-by: Zhonglei Ma Co-authored-by: Dapeng Zhang Co-authored-by: Praven Kuttappan <55455725+praveenkuttappan@users.noreply.github.com> Co-authored-by: Nisha Bhatia <67986960+nisha-bhatia@users.noreply.github.com> Co-authored-by: Alan Zimmer <48699787+alzimmermsft@users.noreply.github.com> Co-authored-by: Laurent Mazuel Co-authored-by: Crystal YU --- .../emitter/src/lib/client-model-builder.ts | 6 +- .../emitter/src/lib/converter.ts | 16 +- .../emitter/src/lib/operation-converter.ts | 11 +- .../emitter/src/lib/typespec-server.ts | 7 +- .../emitter/src/type/http-response-header.ts | 3 +- .../emitter/src/type/input-client.ts | 3 +- .../emitter/src/type/input-operation.ts | 2 +- .../emitter/src/type/input-parameter.ts | 3 +- .../emitter/src/type/input-type.ts | 3 +- .../emitter/test/Unit/model-type.test.ts | 4 +- .../emitter/test/Unit/property-type.test.ts | 6 +- .../src/Providers/ClientOptionsProvider.cs | 7 +- .../src/Providers/RestClientProvider.cs | 3 +- .../Providers/ScmMethodProviderCollection.cs | 7 +- .../ClientProviderSubClientTests.cs | 10 +- .../ClientProviders/ClientProviderTests.cs | 6 +- .../MrwSerializationTypeDefinitionTests.cs | 4 +- .../src/InputTypes/InputClient.cs | 10 +- .../src/InputTypes/InputEnumType.cs | 8 +- .../src/InputTypes/InputEnumTypeFloatValue.cs | 2 +- .../InputTypes/InputEnumTypeIntegerValue.cs | 2 +- .../InputTypes/InputEnumTypeStringValue.cs | 2 +- .../src/InputTypes/InputEnumTypeValue.cs | 8 +- .../src/InputTypes/InputModelProperty.cs | 8 +- .../src/InputTypes/InputModelType.cs | 12 +- .../src/InputTypes/InputOperation.cs | 12 +- .../src/InputTypes/InputParameter.cs | 9 +- .../src/InputTypes/OperationResponseHeader.cs | 13 +- .../TypeSpecInputClientConverter.cs | 9 +- .../TypeSpecInputEnumTypeConverter.cs | 13 +- .../TypeSpecInputEnumTypeValueConverter.cs | 12 +- .../TypeSpecInputModelPropertyConverter.cs | 8 +- .../TypeSpecInputModelTypeConverter.cs | 12 +- .../TypeSpecInputOperationConverter.cs | 9 +- .../TypeSpecInputParameterConverter.cs | 9 +- ...ypeSpecOperationResponseHeaderConverter.cs | 9 +- .../perf/CodeWriterBenchmark.cs | 4 +- .../src/Providers/EnumProvider.cs | 3 +- .../src/Providers/ExtensibleEnumProvider.cs | 3 +- .../src/Providers/FixedEnumProvider.cs | 3 +- .../src/Providers/ModelProvider.cs | 3 +- .../src/Providers/ParameterProvider.cs | 3 +- .../src/Providers/PropertyProvider.cs | 5 +- .../src/Utilities/DocHelpers.cs | 25 + .../test/common/InputFactory.cs | 19 +- .../authentication/api-key/tspCodeModel.json | 8 +- .../http/custom/tspCodeModel.json | 8 +- .../authentication/oauth2/tspCodeModel.json | 8 +- .../authentication/union/tspCodeModel.json | 8 +- .../http/client/naming/tspCodeModel.json | 32 +- .../client-operation-group/tspCodeModel.json | 20 +- .../structure/default/tspCodeModel.json | 30 +- .../structure/multi-client/tspCodeModel.json | 8 +- .../renamed-operation/tspCodeModel.json | 8 +- .../two-operation-group/tspCodeModel.json | 12 +- .../http/encode/bytes/tspCodeModel.json | 28 +- .../http/encode/datetime/tspCodeModel.json | 22 +- .../http/encode/duration/tspCodeModel.json | 22 +- .../http/encode/numeric/tspCodeModel.json | 12 +- .../http/parameters/basic/tspCodeModel.json | 14 +- .../body-optionality/tspCodeModel.json | 14 +- .../collection-format/tspCodeModel.json | 20 +- .../http/parameters/spread/tspCodeModel.json | 42 +- .../content-negotiation/tspCodeModel.json | 8 +- .../json-merge-patch/tspCodeModel.json | 18 +- .../http/payload/media-type/tspCodeModel.json | 6 +- .../http/payload/multipart/tspCodeModel.json | 40 +- .../srv-driven/v1/tspCodeModel.json | 22 +- .../srv-driven/v2/tspCodeModel.json | 32 +- .../CadlRanch/http/routes/tspCodeModel.json | 48 +- .../encoded-name/json/tspCodeModel.json | 10 +- .../endpoint/not-defined/tspCodeModel.json | 4 +- .../server/path/multiple/tspCodeModel.json | 8 +- .../http/server/path/single/tspCodeModel.json | 4 +- .../versions/not-versioned/tspCodeModel.json | 4 +- .../versions/versioned/tspCodeModel.json | 10 +- .../conditional-request/tspCodeModel.json | 20 +- .../repeatability/tspCodeModel.json | 8 +- .../http/special-words/tspCodeModel.json | 88 ++-- .../http/type/array/tspCodeModel.json | 92 ++-- .../http/type/dictionary/tspCodeModel.json | 74 +-- .../type/enum/extensible/tspCodeModel.json | 24 +- .../http/type/enum/fixed/tspCodeModel.json | 34 +- .../http/type/model/empty/tspCodeModel.json | 14 +- .../enum-discriminator/tspCodeModel.json | 56 +-- .../nested-discriminator/tspCodeModel.json | 20 +- .../not-discriminated/tspCodeModel.json | 14 +- .../inheritance/recursive/tspCodeModel.json | 10 +- .../single-discriminator/tspCodeModel.json | 24 +- .../http/type/model/usage/tspCodeModel.json | 14 +- .../type/model/visibility/tspCodeModel.json | 36 +- .../additional-properties/tspCodeModel.json | 470 +++++++++--------- .../type/property/nullable/tspCodeModel.json | 148 +++--- .../property/optionality/tspCodeModel.json | 308 ++++++------ .../property/value-types/tspCodeModel.json | 436 ++++++++-------- .../http/type/scalar/tspCodeModel.json | 56 +-- .../http/type/union/tspCodeModel.json | 90 ++-- .../versioning/added/v1/tspCodeModel.json | 12 +- .../versioning/added/v2/tspCodeModel.json | 22 +- .../madeOptional/v1/tspCodeModel.json | 12 +- .../madeOptional/v2/tspCodeModel.json | 14 +- .../versioning/removed/v1/tspCodeModel.json | 28 +- .../versioning/removed/v2/tspCodeModel.json | 20 +- .../removed/v2Preview/tspCodeModel.json | 30 +- .../renamedFrom/v1/tspCodeModel.json | 18 +- .../renamedFrom/v2/tspCodeModel.json | 20 +- .../v1/tspCodeModel.json | 12 +- .../v2/tspCodeModel.json | 14 +- .../typeChangedFrom/v1/tspCodeModel.json | 12 +- .../typeChangedFrom/v2/tspCodeModel.json | 14 +- .../Unbranded-TypeSpec/tspCodeModel.json | 186 +++---- 111 files changed, 1706 insertions(+), 1610 deletions(-) create mode 100644 packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Utilities/DocHelpers.cs diff --git a/packages/http-client-csharp/emitter/src/lib/client-model-builder.ts b/packages/http-client-csharp/emitter/src/lib/client-model-builder.ts index 153be5f631..359a2e7512 100644 --- a/packages/http-client-csharp/emitter/src/lib/client-model-builder.ts +++ b/packages/http-client-csharp/emitter/src/lib/client-model-builder.ts @@ -85,7 +85,8 @@ export function createModel(sdkContext: SdkContext): CodeMode const clientParameters = fromSdkEndpointParameter(endpointParameter); return { Name: getClientName(client, parentNames), - Description: client.summary ?? client.doc, + Summary: client.summary, + Doc: client.doc, Operations: client.methods .filter((m) => m.kind !== "clientaccessor") .map((m) => @@ -156,7 +157,8 @@ export function createModel(sdkContext: SdkContext): CodeMode parameters.push({ Name: parameter.name, NameInRequest: parameter.serializedName, - Description: parameter.doc, + Summary: parameter.summary, + Doc: parameter.doc, // TODO: we should do the magic in generator Type: parameterType, Location: RequestLocation.Uri, diff --git a/packages/http-client-csharp/emitter/src/lib/converter.ts b/packages/http-client-csharp/emitter/src/lib/converter.ts index 5961fcba1c..df365062b4 100644 --- a/packages/http-client-csharp/emitter/src/lib/converter.ts +++ b/packages/http-client-csharp/emitter/src/lib/converter.ts @@ -122,7 +122,8 @@ export function fromSdkModelType( ) /* when tcgc provide a way to identify if the access is override or not, we can get the accessibility from the modelType.access */, usage: modelType.usage, deprecation: modelType.deprecation, - description: modelType.summary ?? modelType.doc, + doc: modelType.doc, + summary: modelType.summary, discriminatorValue: modelType.discriminatorValue, decorators: modelType.decorators, } as InputModelType; @@ -185,7 +186,8 @@ export function fromSdkModelType( kind: property.kind, name: property.name, serializedName: serializedName, - description: property.summary ?? property.doc, + summary: property.summary, + doc: property.doc, type: fromSdkType( targetType, context, @@ -225,7 +227,8 @@ export function fromSdkEnumType( enumType.__raw as any, ) /* when tcgc provide a way to identify if the access is override or not, we can get the accessibility from the enumType.access,*/, deprecation: enumType.deprecation, - description: enumType.summary ?? enumType.doc, + summary: enumType.summary, + doc: enumType.doc, isFixed: enumType.isFixed, isFlags: enumType.isFlags, usage: enumType.usage, @@ -337,7 +340,7 @@ function fromSdkConstantType( values: values, crossLanguageDefinitionId: "", access: undefined, - description: `The ${enumName}`, // TODO -- what should we put here? + doc: `The ${enumName}`, // TODO -- what should we put here? isFixed: false, isFlags: false, usage: literalTypeContext.Usage, @@ -350,7 +353,7 @@ function fromSdkConstantType( kind: "enumvalue", name: enumValueName, value: constantType.value as string | number, - description: enumValueName, + doc: enumValueName, valueType: enumType.valueType, enumType: enumType, }); @@ -386,7 +389,8 @@ function fromSdkEnumValueType( value: enumValueType.value, valueType: fromSdkBuiltInType(enumValueType.valueType), enumType: fromSdkEnumType(enumValueType.enumType, context, typeMap), - description: enumValueType.summary ?? enumValueType.doc, + summary: enumValueType.summary, + doc: enumValueType.doc, decorators: enumValueType.decorators, }; } diff --git a/packages/http-client-csharp/emitter/src/lib/operation-converter.ts b/packages/http-client-csharp/emitter/src/lib/operation-converter.ts index 6a1b182add..1d628c58d6 100644 --- a/packages/http-client-csharp/emitter/src/lib/operation-converter.ts +++ b/packages/http-client-csharp/emitter/src/lib/operation-converter.ts @@ -30,6 +30,7 @@ import { InputOperation } from "../type/input-operation.js"; import { InputParameter } from "../type/input-parameter.js"; import { InputType } from "../type/input-type.js"; import { convertLroFinalStateVia } from "../type/operation-final-state-via.js"; +import { OperationLongRunning } from "../type/operation-long-running.js"; import { OperationPaging } from "../type/operation-paging.js"; import { OperationResponse } from "../type/operation-response.js"; import { RequestLocation } from "../type/request-location.js"; @@ -75,7 +76,7 @@ export function fromSdkServiceMethod( getOperationGroupName(sdkContext, method.operation, sdkContext.sdkPackage.rootNamespace), Deprecated: getDeprecated(sdkContext.program, method.__raw!), Summary: method.summary, - Description: method.doc, + Doc: method.doc, Accessibility: method.access, Parameters: [...parameterMap.values()], Responses: [...responseMap.values()], @@ -189,7 +190,8 @@ function fromSdkHttpOperationParameter( return { Name: p.name, NameInRequest: p.kind === "header" ? normalizeHeaderName(serializedName) : serializedName, - Description: p.summary ?? p.doc, + Summary: p.summary, + Doc: p.doc, Type: parameterType, Location: getParameterLocation(p), IsApiVersion: @@ -210,7 +212,7 @@ function loadLongRunningOperation( method: SdkServiceMethod, sdkContext: SdkContext, typeMap: SdkTypeMap, -): import("../type/operation-long-running.js").OperationLongRunning | undefined { +): OperationLongRunning | undefined { if (method.kind !== "lro") { return undefined; } @@ -260,7 +262,8 @@ function fromSdkServiceResponseHeaders( ({ Name: h.__raw!.name, NameInResponse: h.serializedName, - Description: h.summary ?? h.doc, + Summary: h.summary, + Doc: h.doc, Type: fromSdkType(h.type, sdkContext, typeMap), }) as HttpResponseHeader, ); diff --git a/packages/http-client-csharp/emitter/src/lib/typespec-server.ts b/packages/http-client-csharp/emitter/src/lib/typespec-server.ts index b70487b652..ffc15ca97f 100644 --- a/packages/http-client-csharp/emitter/src/lib/typespec-server.ts +++ b/packages/http-client-csharp/emitter/src/lib/typespec-server.ts @@ -2,7 +2,7 @@ // Licensed under the MIT License. See License.txt in the project root for license information. import { SdkContext } from "@azure-tools/typespec-client-generator-core"; -import { getDoc } from "@typespec/compiler"; +import { getDoc, getSummary } from "@typespec/compiler"; import { HttpServer } from "@typespec/http"; import { getExtensions } from "@typespec/openapi"; import { NetEmitterOptions } from "../options.js"; @@ -50,7 +50,8 @@ export function resolveServers( const variable: InputParameter = { Name: name, NameInRequest: name, - Description: getDoc(context.program, prop), + Summary: getSummary(context.program, prop), + Doc: getDoc(context.program, prop), Type: inputType, Location: RequestLocation.Uri, IsApiVersion: name.toLowerCase() === "apiversion" || name.toLowerCase() === "api-version", @@ -73,7 +74,7 @@ export function resolveServers( const variable: InputParameter = { Name: "host", NameInRequest: "host", - Description: server.description, + Doc: server.description, Type: { kind: "string", name: "string", diff --git a/packages/http-client-csharp/emitter/src/type/http-response-header.ts b/packages/http-client-csharp/emitter/src/type/http-response-header.ts index 3b866d8749..29a2345a1d 100644 --- a/packages/http-client-csharp/emitter/src/type/http-response-header.ts +++ b/packages/http-client-csharp/emitter/src/type/http-response-header.ts @@ -6,6 +6,7 @@ import { InputType } from "./input-type.js"; export interface HttpResponseHeader { Name: string; NameInResponse: string; - Description: string; + Summary: string; + Doc: string; Type: InputType; } diff --git a/packages/http-client-csharp/emitter/src/type/input-client.ts b/packages/http-client-csharp/emitter/src/type/input-client.ts index df4a22358b..bd9a62c8e7 100644 --- a/packages/http-client-csharp/emitter/src/type/input-client.ts +++ b/packages/http-client-csharp/emitter/src/type/input-client.ts @@ -8,7 +8,8 @@ import { Protocols } from "./protocols.js"; export interface InputClient { Name: string; - Description?: string; + Summary?: string; + Doc?: string; Operations: InputOperation[]; Protocol?: Protocols; Parent?: string; diff --git a/packages/http-client-csharp/emitter/src/type/input-operation.ts b/packages/http-client-csharp/emitter/src/type/input-operation.ts index 8a8fb8e366..879d7a8c2a 100644 --- a/packages/http-client-csharp/emitter/src/type/input-operation.ts +++ b/packages/http-client-csharp/emitter/src/type/input-operation.ts @@ -21,7 +21,7 @@ export interface InputOperation { ResourceName?: string; Summary?: string; Deprecated?: string; - Description?: string; + Doc?: string; Accessibility?: string; Parameters: InputParameter[]; Responses: OperationResponse[]; diff --git a/packages/http-client-csharp/emitter/src/type/input-parameter.ts b/packages/http-client-csharp/emitter/src/type/input-parameter.ts index ff130bdcfe..323af960d6 100644 --- a/packages/http-client-csharp/emitter/src/type/input-parameter.ts +++ b/packages/http-client-csharp/emitter/src/type/input-parameter.ts @@ -12,7 +12,8 @@ export interface VirtualParameter {} export interface InputParameter { Name: string; NameInRequest: string; - Description?: string; + Summary?: string; + Doc?: string; Type: InputType; Location: RequestLocation; DefaultValue?: InputConstant; diff --git a/packages/http-client-csharp/emitter/src/type/input-type.ts b/packages/http-client-csharp/emitter/src/type/input-type.ts index 2c43bdbbbd..5009ba1520 100644 --- a/packages/http-client-csharp/emitter/src/type/input-type.ts +++ b/packages/http-client-csharp/emitter/src/type/input-type.ts @@ -11,7 +11,8 @@ import { DateTimeKnownEncoding, DurationKnownEncoding } from "@typespec/compiler interface InputTypeBase { kind: string; - description?: string; + summary?: string; + doc?: string; deprecation?: string; decorators?: DecoratorInfo[]; } diff --git a/packages/http-client-csharp/emitter/test/Unit/model-type.test.ts b/packages/http-client-csharp/emitter/test/Unit/model-type.test.ts index 0507379fe4..8938d50f37 100644 --- a/packages/http-client-csharp/emitter/test/Unit/model-type.test.ts +++ b/packages/http-client-csharp/emitter/test/Unit/model-type.test.ts @@ -141,7 +141,7 @@ op test(@body input: Pet): Pet; const discriminatorProperty = pet?.properties.find((p) => p === pet?.discriminatorProperty); strictEqual(discriminatorProperty?.name, "kind"); strictEqual(discriminatorProperty.serializedName, "kind"); - strictEqual(discriminatorProperty.description, "The kind of the pet"); + strictEqual(discriminatorProperty.doc, "The kind of the pet"); strictEqual(discriminatorProperty.type.kind, "enum"); strictEqual(discriminatorProperty.type.name, "PetKind"); strictEqual(discriminatorProperty.type.valueType.kind, "string"); @@ -234,7 +234,7 @@ op test(@body input: Pet): Pet; const discriminatorProperty = pet?.properties.find((p) => p === pet?.discriminatorProperty); strictEqual(discriminatorProperty?.name, "kind"); strictEqual(discriminatorProperty.serializedName, "kind"); - strictEqual(discriminatorProperty.description, "The kind of the pet"); + strictEqual(discriminatorProperty.doc, "The kind of the pet"); strictEqual(discriminatorProperty.type.kind, "enum"); strictEqual(discriminatorProperty.type.name, "PetKind"); strictEqual(discriminatorProperty.type.valueType.kind, "string"); diff --git a/packages/http-client-csharp/emitter/test/Unit/property-type.test.ts b/packages/http-client-csharp/emitter/test/Unit/property-type.test.ts index 3af457a25c..83927b4172 100644 --- a/packages/http-client-csharp/emitter/test/Unit/property-type.test.ts +++ b/packages/http-client-csharp/emitter/test/Unit/property-type.test.ts @@ -95,7 +95,7 @@ describe("Test GetInputType for enum", () => { strictEqual(type.kind, "enum"); strictEqual(type.name, "SimpleEnum"); strictEqual(type.isFixed, true); - strictEqual(type.description, "fixed string enum"); + strictEqual(type.doc, "fixed string enum"); strictEqual(type.crossLanguageDefinitionId, "Azure.Csharp.Testing.SimpleEnum"); strictEqual(type.access, undefined); strictEqual(type.valueType.kind, "string"); @@ -142,7 +142,7 @@ describe("Test GetInputType for enum", () => { strictEqual(type.name, "FixedIntEnum"); strictEqual(type.crossLanguageDefinitionId, "Azure.Csharp.Testing.FixedIntEnum"); strictEqual(type.access, undefined); - strictEqual(type.description, "Fixed int enum"); + strictEqual(type.doc, "Fixed int enum"); strictEqual(type.valueType.crossLanguageDefinitionId, "TypeSpec.int32"); strictEqual(type.valueType.kind, "int32"); strictEqual(type.values.length, 3); @@ -181,7 +181,7 @@ describe("Test GetInputType for enum", () => { strictEqual(type.name, "FixedEnum"); strictEqual(type.crossLanguageDefinitionId, "Azure.Csharp.Testing.FixedEnum"); strictEqual(type.access, undefined); - strictEqual(type.description, "Fixed enum"); + strictEqual(type.doc, "Fixed enum"); strictEqual(type.valueType.kind, "string"); strictEqual(type.valueType.crossLanguageDefinitionId, "TypeSpec.string"); strictEqual(type.values.length, 3); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ClientOptionsProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ClientOptionsProvider.cs index 95d7296ad9..045d887b82 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ClientOptionsProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ClientOptionsProvider.cs @@ -9,8 +9,8 @@ using Microsoft.Generator.CSharp.Input; using Microsoft.Generator.CSharp.Primitives; using Microsoft.Generator.CSharp.Providers; +using Microsoft.Generator.CSharp.Utilities; using static Microsoft.Generator.CSharp.Snippets.Snippet; -using System.ClientModel.Primitives; namespace Microsoft.Generator.CSharp.ClientModel.Providers { @@ -125,9 +125,10 @@ protected override PropertyProvider[] BuildProperties() if (!p.IsEndpoint && !p.IsApiVersion && p.DefaultValue != null) { FormattableString? description = null; - if (p.Description != null) + var parameterDescription = DocHelpers.GetDescription(p.Summary, p.Doc); + if (parameterDescription is not null) { - description = $"{p.Description}"; + description = $"{parameterDescription}"; } var type = ClientModelPlugin.Instance.TypeFactory.CreateCSharpType(p.Type)?.PropertyInitializationType; diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/RestClientProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/RestClientProvider.cs index 65c737b876..0376b6d5eb 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/RestClientProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/RestClientProvider.cs @@ -442,7 +442,8 @@ private static IReadOnlyList BuildSpreadParametersForModel(In var inputParameter = new InputParameter( property.Name, property.SerializedName, - property.Description, + property.Summary, + property.Doc, property.Type, RequestLocation.Body, null, diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ScmMethodProviderCollection.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ScmMethodProviderCollection.cs index 9d15700917..acb3ca6f86 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ScmMethodProviderCollection.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/src/Providers/ScmMethodProviderCollection.cs @@ -14,6 +14,7 @@ using Microsoft.Generator.CSharp.Providers; using Microsoft.Generator.CSharp.Snippets; using Microsoft.Generator.CSharp.Statements; +using Microsoft.Generator.CSharp.Utilities; using static Microsoft.Generator.CSharp.Snippets.Snippet; namespace Microsoft.Generator.CSharp.ClientModel.Providers @@ -71,7 +72,7 @@ private ScmMethodProvider BuildConvenienceMethod(MethodProvider protocolMethod, var methodSignature = new MethodSignature( isAsync ? _cleanOperationName + "Async" : _cleanOperationName, - FormattableStringHelpers.FromString(Operation.Description), + DocHelpers.GetFormattableDescription(Operation.Summary, Operation.Doc) ?? FormattableStringHelpers.FromString(Operation.Name), methodModifier, GetResponseType(Operation.Responses, true, isAsync, out var responseBodyType), null, @@ -421,7 +422,7 @@ private ScmMethodProvider BuildProtocolMethod(MethodProvider createRequestMethod var methodSignature = new MethodSignature( isAsync ? _cleanOperationName + "Async" : _cleanOperationName, - FormattableStringHelpers.FromString(Operation.Description), + DocHelpers.GetFormattableDescription(Operation.Summary, Operation.Doc) ?? FormattableStringHelpers.FromString(Operation.Name), methodModifier, GetResponseType(Operation.Responses, false, isAsync, out _), $"The response returned from the service.", @@ -447,7 +448,7 @@ private ScmMethodProvider BuildProtocolMethod(MethodProvider createRequestMethod new XmlDocStatement("item", [], new XmlDocStatement("description", [$"This protocol method allows explicit creation of the request and processing of the response for advanced scenarios."])) ]; XmlDocStatement listXmlDoc = new XmlDocStatement("", "", [], innerStatements: [.. listItems]); - protocolMethod.XmlDocs!.Summary = new XmlDocSummaryStatement([$"[Protocol Method] {Operation.Description}"], listXmlDoc); + protocolMethod.XmlDocs!.Summary = new XmlDocSummaryStatement([$"[Protocol Method] {DocHelpers.GetDescription(Operation.Summary, Operation.Doc) ?? Operation.Name}"], listXmlDoc); } return protocolMethod; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderSubClientTests.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderSubClientTests.cs index 66d20fdb62..bd9f33aba3 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderSubClientTests.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderSubClientTests.cs @@ -14,11 +14,11 @@ namespace Microsoft.Generator.CSharp.ClientModel.Tests.Providers.ClientProviders public class ClientProviderSubClientTests { private const string TestClientName = "TestClient"; - private static readonly InputClient _animalClient = new("animal", "AnimalClient description", [], [], TestClientName); - private static readonly InputClient _dogClient = new("dog", "DogClient description", [], [], _animalClient.Name); - private static readonly InputClient _catClient = new("cat", "CatClient description", [], [], _animalClient.Name); - private static readonly InputClient _hawkClient = new("hawkClient", "HawkClient description", [], [], _animalClient.Name); - private static readonly InputClient _huskyClient = new("husky", "HuskyClient description", [], [], _dogClient.Name); + private static readonly InputClient _animalClient = new("animal", string.Empty, "AnimalClient description", [], [], TestClientName); + private static readonly InputClient _dogClient = new("dog", string.Empty, "DogClient description", [], [], _animalClient.Name); + private static readonly InputClient _catClient = new("cat", string.Empty, "CatClient description", [], [], _animalClient.Name); + private static readonly InputClient _hawkClient = new("hawkClient", string.Empty, "HawkClient description", [], [], _animalClient.Name); + private static readonly InputClient _huskyClient = new("husky", string.Empty, "HuskyClient description", [], [], _dogClient.Name); [SetUp] public void SetUp() diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderTests.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderTests.cs index b221fcd4ec..f2bf2050cc 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderTests.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/ClientProviders/ClientProviderTests.cs @@ -26,9 +26,9 @@ public class ClientProviderTests private const string KeyAuthCategory = "WithKeyAuth"; private const string OAuth2Category = "WithOAuth2"; private const string TestClientName = "TestClient"; - private static readonly InputClient _animalClient = new("animal", "AnimalClient description", [], [], TestClientName); - private static readonly InputClient _dogClient = new("dog", "DogClient description", [], [], _animalClient.Name); - private static readonly InputClient _huskyClient = new("husky", "HuskyClient description", [], [], _dogClient.Name); + private static readonly InputClient _animalClient = new("animal", "", "AnimalClient description", [], [], TestClientName); + private static readonly InputClient _dogClient = new("dog", "", "DogClient description", [], [], _animalClient.Name); + private static readonly InputClient _huskyClient = new("husky", "", "HuskyClient description", [], [], _dogClient.Name); private static readonly InputModelType _spreadModel = InputFactory.Model( "spreadModel", usage: InputModelTypeUsage.Spread, diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/MrwSerializationTypeDefinitions/MrwSerializationTypeDefinitionTests.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/MrwSerializationTypeDefinitions/MrwSerializationTypeDefinitionTests.cs index e328c3f819..42689ac6d8 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/MrwSerializationTypeDefinitions/MrwSerializationTypeDefinitionTests.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.ClientModel/test/Providers/MrwSerializationTypeDefinitions/MrwSerializationTypeDefinitionTests.cs @@ -690,10 +690,10 @@ public void TestIntSerializationStatement( var name = kind.ToString().ToLower(); var properties = new List { - new InputModelProperty("requiredInt", "requiredInt", "", new InputPrimitiveType(kind, name, $"TypeSpec.{name}", encode), true, false, false), + new InputModelProperty("requiredInt", "requiredInt", "", "", new InputPrimitiveType(kind, name, $"TypeSpec.{name}", encode), true, false, false), }; - var inputModel = new InputModelType("TestModel", "TestModel", "public", null, "Test model.", InputModelTypeUsage.Input, properties, null, Array.Empty(), null, null, new Dictionary(), null, false); + var inputModel = new InputModelType("TestModel", "TestModel", "public", null, "", "Test model.", InputModelTypeUsage.Input, properties, null, Array.Empty(), null, null, new Dictionary(), null, false); var (_, serialization) = CreateModelAndSerialization(inputModel); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputClient.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputClient.cs index 38d90dbf1c..ea3690e487 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputClient.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputClient.cs @@ -11,19 +11,21 @@ public class InputClient private readonly string? _key; private IReadOnlyDictionary? _examples; - public InputClient(string name, string description, IReadOnlyList operations, IReadOnlyList parameters, string? parent) + public InputClient(string name, string? summary, string? doc, IReadOnlyList operations, IReadOnlyList parameters, string? parent) { Name = name; - Description = description; + Summary = summary; + Doc = doc; Operations = operations; Parameters = parameters; Parent = parent; } - public InputClient() : this(string.Empty, string.Empty, Array.Empty(), Array.Empty(), null) { } + public InputClient() : this(string.Empty, string.Empty, string.Empty, Array.Empty(), Array.Empty(), null) { } public string Name { get; internal set; } - public string Description { get; internal set; } + public string? Summary { get; internal set; } + public string? Doc { get; internal set; } public IReadOnlyList Operations { get; internal set; } public IReadOnlyList Parameters { get; internal set; } public string? Parent { get; internal set; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumType.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumType.cs index dde598de30..968229d763 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumType.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumType.cs @@ -7,13 +7,14 @@ namespace Microsoft.Generator.CSharp.Input { public class InputEnumType : InputType { - public InputEnumType(string name, string crossLanguageDefinitionId, string? accessibility, string? deprecated, string description, InputModelTypeUsage usage, InputPrimitiveType valueType, IReadOnlyList values, bool isExtensible) + public InputEnumType(string name, string crossLanguageDefinitionId, string? accessibility, string? deprecated, string? summary, string? doc, InputModelTypeUsage usage, InputPrimitiveType valueType, IReadOnlyList values, bool isExtensible) : base(name) { CrossLanguageDefinitionId = crossLanguageDefinitionId; Accessibility = accessibility; Deprecated = deprecated; - Description = description; + Summary = summary; + Doc = doc; Usage = usage; ValueType = valueType; Values = values; @@ -23,7 +24,8 @@ public InputEnumType(string name, string crossLanguageDefinitionId, string? acce public string CrossLanguageDefinitionId { get; } public string? Accessibility { get; } public string? Deprecated { get; } - public string Description { get; } + public string? Summary { get; } + public string? Doc { get; } public InputModelTypeUsage Usage { get; } public InputPrimitiveType ValueType { get; } public IReadOnlyList Values { get; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeFloatValue.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeFloatValue.cs index 975a2815aa..f71ee8f89e 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeFloatValue.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeFloatValue.cs @@ -5,7 +5,7 @@ namespace Microsoft.Generator.CSharp.Input { internal class InputEnumTypeFloatValue : InputEnumTypeValue { - public InputEnumTypeFloatValue(string name, float floatValue, InputPrimitiveType valueType, string? description) : base(name, floatValue, valueType, description) + public InputEnumTypeFloatValue(string name, float floatValue, InputPrimitiveType valueType, string? summary, string? doc) : base(name, floatValue, valueType, summary, doc) { FloatValue = floatValue; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeIntegerValue.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeIntegerValue.cs index 61aab61a41..7c7850c5ab 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeIntegerValue.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeIntegerValue.cs @@ -5,7 +5,7 @@ namespace Microsoft.Generator.CSharp.Input { internal class InputEnumTypeIntegerValue : InputEnumTypeValue { - public InputEnumTypeIntegerValue(string name, int integerValue, InputPrimitiveType valueType, string? description) : base(name, integerValue, valueType, description) + public InputEnumTypeIntegerValue(string name, int integerValue, InputPrimitiveType valueType, string? summary, string? doc) : base(name, integerValue, valueType, summary, doc) { IntegerValue = integerValue; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeStringValue.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeStringValue.cs index ddaa8cd36e..d662cd1e79 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeStringValue.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeStringValue.cs @@ -5,7 +5,7 @@ namespace Microsoft.Generator.CSharp.Input { internal class InputEnumTypeStringValue : InputEnumTypeValue { - public InputEnumTypeStringValue(string name, string stringValue, InputPrimitiveType valueType, string? description) : base(name, stringValue, valueType, description) + public InputEnumTypeStringValue(string name, string stringValue, InputPrimitiveType valueType, string? summary, string? doc) : base(name, stringValue, valueType, summary, doc) { StringValue = stringValue; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeValue.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeValue.cs index 5b57099997..7a8878b7b8 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeValue.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputEnumTypeValue.cs @@ -7,18 +7,20 @@ namespace Microsoft.Generator.CSharp.Input { public class InputEnumTypeValue { - public InputEnumTypeValue(string name, object value, InputPrimitiveType valueType, string? description) + public InputEnumTypeValue(string name, object value, InputPrimitiveType valueType, string? summary, string? doc) { Name = name; Value = value; ValueType = valueType; - Description = description; + Summary = summary; + Doc = doc; } public string Name { get; } public object Value { get; } public InputPrimitiveType ValueType { get; } - public string? Description { get; } + public string? Summary { get; } + public string? Doc { get; } public IReadOnlyList Decorators { get; internal set; } = new List(); public virtual string GetJsonValueString() => GetValueString(); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelProperty.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelProperty.cs index 89a4229598..b86ccf8ae3 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelProperty.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelProperty.cs @@ -8,11 +8,12 @@ namespace Microsoft.Generator.CSharp.Input { public class InputModelProperty { - public InputModelProperty(string name, string serializedName, string? description, InputType type, bool isRequired, bool isReadOnly, bool isDiscriminator) + public InputModelProperty(string name, string serializedName, string? summary, string? doc, InputType type, bool isRequired, bool isReadOnly, bool isDiscriminator) { Name = name; SerializedName = serializedName; - Description = description; + Summary = summary; + Doc = doc; Type = type; IsRequired = isRequired; IsReadOnly = isReadOnly; @@ -21,7 +22,8 @@ public InputModelProperty(string name, string serializedName, string? descriptio public string Name { get; } public string SerializedName { get; } - public string? Description { get; } + public string? Summary { get; } + public string? Doc { get; } public InputType Type { get; } public bool IsRequired { get; } public bool IsReadOnly { get; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelType.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelType.cs index 6c0c800c9c..d151011cc5 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelType.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputModelType.cs @@ -15,13 +15,14 @@ public class InputModelType : InputType private IList _derivedModels = []; // TODO: Follow up issue https://github.com/microsoft/typespec/issues/3619. After https://github.com/Azure/typespec-azure/pull/966 is completed, update this type and remove the "modelAsStruct" parameter. - public InputModelType(string name, string crossLanguageDefinitionId, string? access, string? deprecation, string? description, InputModelTypeUsage usage, IReadOnlyList properties, InputModelType? baseModel, IReadOnlyList derivedModels, string? discriminatorValue, InputModelProperty? discriminatorProperty, IReadOnlyDictionary discriminatedSubtypes, InputType? additionalProperties, bool modelAsStruct) + public InputModelType(string name, string crossLanguageDefinitionId, string? access, string? deprecation, string? summary, string? doc, InputModelTypeUsage usage, IReadOnlyList properties, InputModelType? baseModel, IReadOnlyList derivedModels, string? discriminatorValue, InputModelProperty? discriminatorProperty, IReadOnlyDictionary discriminatedSubtypes, InputType? additionalProperties, bool modelAsStruct) : base(name) { CrossLanguageDefinitionId = crossLanguageDefinitionId; Access = access; Deprecation = deprecation; - Description = description; + Summary = summary; + Doc = doc; Usage = usage; Properties = properties; BaseModel = baseModel; @@ -48,7 +49,8 @@ public InputModelType(string name, string crossLanguageDefinitionId, string? acc public string CrossLanguageDefinitionId { get; internal set; } public string? Access { get; internal set; } public string? Deprecation { get; internal set; } - public string? Description { get; internal set; } + public string? Summary { get; internal set; } + public string? Doc { get; internal set; } public InputModelTypeUsage Usage { get; internal set; } public IReadOnlyList Properties @@ -93,6 +95,7 @@ internal set $"Unknown{cleanBaseName}", "internal", null, + null, $"Unknown variant of {cleanBaseName}", Usage | InputModelTypeUsage.Json, [], @@ -102,7 +105,8 @@ internal set new InputModelProperty( DiscriminatorProperty!.Name, DiscriminatorProperty.SerializedName, - DiscriminatorProperty.Description, + DiscriminatorProperty.Summary, + DiscriminatorProperty.Doc, DiscriminatorProperty.Type, DiscriminatorProperty.IsRequired, DiscriminatorProperty.IsReadOnly, diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputOperation.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputOperation.cs index 095704a191..0b7560b6f3 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputOperation.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputOperation.cs @@ -14,7 +14,8 @@ public class InputOperation public InputOperation( string name, string? resourceName, - string description, + string? summary, + string? doc, string? deprecated, string? accessibility, IReadOnlyList parameters, @@ -34,7 +35,8 @@ public InputOperation( { Name = name; ResourceName = resourceName; - Description = description; + Summary = summary; + Doc = doc; Deprecated = deprecated; Accessibility = accessibility; Parameters = parameters; @@ -56,7 +58,8 @@ public InputOperation( public InputOperation() : this( name: string.Empty, resourceName: null, - description: string.Empty, + summary: string.Empty, + doc: string.Empty, deprecated: null, accessibility: null, parameters: Array.Empty(), @@ -77,7 +80,8 @@ public InputOperation() : this( public string Name { get; internal set; } public string? ResourceName { get; internal set; } - public string Description { get; internal set; } + public string? Summary { get; internal set; } + public string? Doc { get; internal set; } public string? Deprecated { get; internal set; } public string? Accessibility { get; internal set; } public IReadOnlyList Parameters { get; internal set; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputParameter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputParameter.cs index 5c15b2eab1..37207af0c4 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputParameter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/InputParameter.cs @@ -12,7 +12,8 @@ public sealed class InputParameter public InputParameter( string name, string nameInRequest, - string? description, + string? summary, + string? doc, InputType type, RequestLocation location, InputConstant? defaultValue, @@ -29,7 +30,8 @@ public InputParameter( { Name = name; NameInRequest = nameInRequest; - Description = description; + Summary = summary; + Doc = doc; Type = type; Location = location; DefaultValue = defaultValue; @@ -47,7 +49,8 @@ public InputParameter( public string Name { get; } public string NameInRequest { get; } - public string? Description { get; } + public string? Summary { get; } + public string? Doc { get; } public InputType Type { get; } public RequestLocation Location { get; } public InputConstant? DefaultValue { get; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/OperationResponseHeader.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/OperationResponseHeader.cs index 00e05a1ae1..65b1c72ff6 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/OperationResponseHeader.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/OperationResponseHeader.cs @@ -11,21 +11,24 @@ public sealed class OperationResponseHeader /// Creates an instance of . /// The name of the header. /// The name of the header in the operation response. - /// The description of the header. + /// The summary of the header. + /// The doc string of the header. /// The input type. - public OperationResponseHeader(string name, string nameInResponse, string description, InputType type) + public OperationResponseHeader(string name, string nameInResponse, string? summary, string? doc, InputType type) { Name = name; NameInResponse = nameInResponse; - Description = description; + Summary = summary; + Doc = doc; Type = type; } - public OperationResponseHeader() : this(string.Empty, string.Empty, string.Empty, InputPrimitiveType.String) { } + public OperationResponseHeader() : this(string.Empty, string.Empty, string.Empty, string.Empty, InputPrimitiveType.String) { } public string Name { get; } public string NameInResponse { get; } - public string Description { get; } + public string? Summary { get; } + public string? Doc { get; } public InputType Type { get; } } } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputClientConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputClientConverter.cs index 7df4c4b773..3bfd8f3bfc 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputClientConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputClientConverter.cs @@ -35,7 +35,8 @@ public override void Write(Utf8JsonWriter writer, InputClient value, JsonSeriali resolver.AddReference(id, client); string? name = null; - string? description = null; + string? summary = null; + string? doc = null; IReadOnlyList? operations = null; IReadOnlyList? parameters = null; IReadOnlyList? decorators = null; @@ -44,7 +45,8 @@ public override void Write(Utf8JsonWriter writer, InputClient value, JsonSeriali while (reader.TokenType != JsonTokenType.EndObject) { var isKnownProperty = reader.TryReadString(nameof(InputClient.Name), ref name) - || reader.TryReadString(nameof(InputClient.Description), ref description) + || reader.TryReadString("Summary", ref summary) + || reader.TryReadString("Doc", ref doc) || reader.TryReadWithConverter(nameof(InputClient.Operations), options, ref operations) || reader.TryReadWithConverter(nameof(InputClient.Parameters), options, ref parameters) || reader.TryReadString(nameof(InputClient.Parent), ref parent) @@ -57,7 +59,8 @@ public override void Write(Utf8JsonWriter writer, InputClient value, JsonSeriali } client.Name = name ?? throw new JsonException("InputClient must have name"); - client.Description = description ?? string.Empty; + client.Summary = summary; + client.Doc = doc; client.Operations = operations ?? Array.Empty(); client.Parameters = parameters ?? Array.Empty(); client.Parent = parent; diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeConverter.cs index 57be445a4b..82fb7d3de6 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeConverter.cs @@ -29,7 +29,8 @@ public static InputEnumType CreateEnumType(ref Utf8JsonReader reader, string? id string? crossLanguageDefinitionId = null; string? accessibility = null; string? deprecated = null; - string? description = null; + string? summary = null; + string? doc = null; InputModelTypeUsage usage = InputModelTypeUsage.None; string? usageString = null; bool isFixed = false; @@ -43,7 +44,8 @@ public static InputEnumType CreateEnumType(ref Utf8JsonReader reader, string? id || reader.TryReadString("crossLanguageDefinitionId", ref crossLanguageDefinitionId) || reader.TryReadString("access", ref accessibility) || reader.TryReadString("deprecation", ref deprecated) - || reader.TryReadString("description", ref description) + || reader.TryReadString("summary", ref summary) + || reader.TryReadString("doc", ref doc) || reader.TryReadString("usage", ref usageString) || reader.TryReadBoolean("isFixed", ref isFixed) || reader.TryReadWithConverter("valueType", options, ref valueType) @@ -57,10 +59,9 @@ public static InputEnumType CreateEnumType(ref Utf8JsonReader reader, string? id } name = name ?? throw new JsonException("Enum must have name"); - if (description == null) + if (summary is null && doc is null) { - description = ""; - Console.Error.WriteLine($"[Warn]: Enum '{name}' must have a description"); + Console.Error.WriteLine($"[Warn]: Enum '{name}' must have either a summary or doc"); } if (usageString != null) @@ -78,7 +79,7 @@ public static InputEnumType CreateEnumType(ref Utf8JsonReader reader, string? id throw new JsonException("The ValueType of an EnumType must be a primitive type."); } - var enumType = new InputEnumType(name, crossLanguageDefinitionId ?? string.Empty, accessibility, deprecated, description!, usage, inputValueType, values, !isFixed) + var enumType = new InputEnumType(name, crossLanguageDefinitionId ?? string.Empty, accessibility, deprecated, summary, doc, usage, inputValueType, values, !isFixed) { Decorators = decorators ?? [] }; diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeValueConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeValueConverter.cs index a100d8e369..0b98b1765a 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeValueConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputEnumTypeValueConverter.cs @@ -28,7 +28,8 @@ private static InputEnumTypeValue CreateEnumTypeValue(ref Utf8JsonReader reader, var isFirstProperty = id == null; JsonElement? rawValue = null; InputPrimitiveType? valueType = null; - string? description = null; + string? summary = null; + string? doc = null; IReadOnlyList? decorators = null; while (reader.TokenType != JsonTokenType.EndObject) { @@ -36,7 +37,8 @@ private static InputEnumTypeValue CreateEnumTypeValue(ref Utf8JsonReader reader, || reader.TryReadString("name", ref name) || reader.TryReadWithConverter("value", options, ref rawValue) || reader.TryReadWithConverter("valueType", options, ref valueType) - || reader.TryReadString("description", ref description) + || reader.TryReadString("summary", ref summary) + || reader.TryReadString("doc", ref doc) || reader.TryReadWithConverter("decorators", options, ref decorators); if (!isKnownProperty) @@ -53,9 +55,9 @@ private static InputEnumTypeValue CreateEnumTypeValue(ref Utf8JsonReader reader, InputEnumTypeValue enumValue = valueType.Kind switch { - InputPrimitiveTypeKind.String => new InputEnumTypeStringValue(name, rawValue.Value.GetString() ?? throw new JsonException(), valueType, description) { Decorators = decorators ?? [] }, - InputPrimitiveTypeKind.Int32 => new InputEnumTypeIntegerValue(name, rawValue.Value.GetInt32(), valueType, description) { Decorators = decorators ?? [] }, - InputPrimitiveTypeKind.Float32 => new InputEnumTypeFloatValue(name, rawValue.Value.GetSingle(), valueType, description) { Decorators = decorators ?? [] }, + InputPrimitiveTypeKind.String => new InputEnumTypeStringValue(name, rawValue.Value.GetString() ?? throw new JsonException(), valueType, summary, doc) { Decorators = decorators ?? [] }, + InputPrimitiveTypeKind.Int32 => new InputEnumTypeIntegerValue(name, rawValue.Value.GetInt32(), valueType, summary, doc) { Decorators = decorators ?? [] }, + InputPrimitiveTypeKind.Float32 => new InputEnumTypeFloatValue(name, rawValue.Value.GetSingle(), valueType, summary, doc) { Decorators = decorators ?? [] }, _ => throw new JsonException() }; if (id != null) diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelPropertyConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelPropertyConverter.cs index 400863e9a1..4b93b74db8 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelPropertyConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelPropertyConverter.cs @@ -27,7 +27,8 @@ private static InputModelProperty ReadInputModelProperty(ref Utf8JsonReader read { var isFirstProperty = true; string? serializedName = null; - string? description = null; + string? summary = null; + string? doc = null; InputType? propertyType = null; bool isReadOnly = false; bool isOptional = false; @@ -39,7 +40,8 @@ private static InputModelProperty ReadInputModelProperty(ref Utf8JsonReader read var isKnownProperty = reader.TryReadReferenceId(ref isFirstProperty, ref id) || reader.TryReadString("name", ref name) || reader.TryReadString("serializedName", ref serializedName) - || reader.TryReadString("description", ref description) + || reader.TryReadString("summary", ref summary) + || reader.TryReadString("doc", ref doc) || reader.TryReadWithConverter("type", options, ref propertyType) || reader.TryReadBoolean("readOnly", ref isReadOnly) || reader.TryReadBoolean("optional", ref isOptional) @@ -57,7 +59,7 @@ private static InputModelProperty ReadInputModelProperty(ref Utf8JsonReader read // description = BuilderHelpers.EscapeXmlDocDescription(description); propertyType = propertyType ?? throw new JsonException($"{nameof(InputModelProperty)} must have a property type."); - var property = new InputModelProperty(name, serializedName ?? name, description, propertyType, !isOptional, isReadOnly, isDiscriminator) { Decorators = decorators ?? [] }; + var property = new InputModelProperty(name, serializedName ?? name, summary, doc, propertyType, !isOptional, isReadOnly, isDiscriminator) { Decorators = decorators ?? [] }; if (id != null) { resolver.AddReference(id, property); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelTypeConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelTypeConverter.cs index 0dc5a8e8ba..89ba7ecd53 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelTypeConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputModelTypeConverter.cs @@ -38,7 +38,8 @@ public static InputModelType CreateModelType(ref Utf8JsonReader reader, string? crossLanguageDefinitionId: null!, access: null, deprecation: null, - description: null, + summary: null, + doc: null, usage: InputModelTypeUsage.None, properties: [], baseModel: null, @@ -53,7 +54,8 @@ public static InputModelType CreateModelType(ref Utf8JsonReader reader, string? string? crossLanguageDefinitionId = null; string? accessibility = null; string? deprecation = null; - string? description = null; + string? summary = null; + string? doc = null; string? usageString = null; InputModelProperty? discriminatorProperty = null; string? discriminatorValue = null; @@ -71,7 +73,8 @@ public static InputModelType CreateModelType(ref Utf8JsonReader reader, string? || reader.TryReadString("crossLanguageDefinitionId", ref crossLanguageDefinitionId) || reader.TryReadString("access", ref accessibility) || reader.TryReadString("deprecation", ref deprecation) - || reader.TryReadString("description", ref description) + || reader.TryReadString("summary", ref doc) + || reader.TryReadString("doc", ref doc) || reader.TryReadString("usage", ref usageString) || reader.TryReadWithConverter("discriminatorProperty", options, ref discriminatorProperty) || reader.TryReadString("discriminatorValue", ref discriminatorValue) @@ -92,7 +95,8 @@ public static InputModelType CreateModelType(ref Utf8JsonReader reader, string? model.CrossLanguageDefinitionId = crossLanguageDefinitionId ?? string.Empty; model.Access = accessibility; model.Deprecation = deprecation; - model.Description = description; + model.Summary = summary; + model.Doc = doc; var parsedUsage = Enum.TryParse(usageString, ignoreCase: true, out var usage) ? usage : InputModelTypeUsage.None; // TO-DO: Manually add JSON usage flag for now until support for parsing this is added to the TSP https://github.com/microsoft/typespec/issues/3392 parsedUsage |= InputModelTypeUsage.Json; diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputOperationConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputOperationConverter.cs index 091a871e17..ff282ce1ae 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputOperationConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputOperationConverter.cs @@ -38,7 +38,8 @@ public override void Write(Utf8JsonWriter writer, InputOperation value, JsonSeri string? name = null; string? resourceName = null; - string? description = null; + string? summary = null; + string? doc = null; string? deprecated = null; string? accessibility = null; IReadOnlyList? parameters = null; @@ -61,7 +62,8 @@ public override void Write(Utf8JsonWriter writer, InputOperation value, JsonSeri { var isKnownProperty = reader.TryReadString(nameof(InputOperation.Name), ref name) || reader.TryReadString(nameof(InputOperation.ResourceName), ref resourceName) - || reader.TryReadString(nameof(InputOperation.Description), ref description) + || reader.TryReadString("Summary", ref summary) + || reader.TryReadString("Doc", ref doc) || reader.TryReadString(nameof(InputOperation.Deprecated), ref deprecated) || reader.TryReadString(nameof(InputOperation.Accessibility), ref accessibility) || reader.TryReadWithConverter(nameof(InputOperation.Parameters), options, ref parameters) @@ -88,7 +90,8 @@ public override void Write(Utf8JsonWriter writer, InputOperation value, JsonSeri operation.Name = name ?? throw new JsonException("InputOperation must have name"); operation.ResourceName = resourceName; - operation.Description = description ?? name; // default to name to avoid a case that we do not have description (and leads to no xml doc at all) + operation.Summary = summary; + operation.Doc = doc; operation.Deprecated = deprecated; operation.Accessibility = accessibility; operation.Parameters = parameters ?? Array.Empty(); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputParameterConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputParameterConverter.cs index d62ba135c9..2ffba1170d 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputParameterConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecInputParameterConverter.cs @@ -30,7 +30,8 @@ public static InputParameter CreateInputParameter(ref Utf8JsonReader reader, str var isFirstProperty = id == null && name == null; string? nameInRequest = null; - string? description = null; + string? summary = null; + string? doc = null; InputType? parameterType = null; string? location = null; InputConstant? defaultValue = null; @@ -50,7 +51,8 @@ public static InputParameter CreateInputParameter(ref Utf8JsonReader reader, str var isKnownProperty = reader.TryReadReferenceId(ref isFirstProperty, ref id) || reader.TryReadString(nameof(InputParameter.Name), ref name) || reader.TryReadString(nameof(InputParameter.NameInRequest), ref nameInRequest) - || reader.TryReadString(nameof(InputParameter.Description), ref description) + || reader.TryReadString("Summary", ref summary) + || reader.TryReadString("Doc", ref doc) || reader.TryReadWithConverter(nameof(InputParameter.Type), options, ref parameterType) || reader.TryReadString(nameof(InputParameter.Location), ref location) || reader.TryReadWithConverter(nameof(InputParameter.DefaultValue), options, ref defaultValue) @@ -96,7 +98,8 @@ public static InputParameter CreateInputParameter(ref Utf8JsonReader reader, str var parameter = new InputParameter( name: name, nameInRequest: nameInRequest, - description: description, + summary: summary, + doc: doc, type: parameterType, location: requestLocation, defaultValue: defaultValue, diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecOperationResponseHeaderConverter.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecOperationResponseHeaderConverter.cs index 6f53bdcae4..5416db308c 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecOperationResponseHeaderConverter.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp.Input/src/InputTypes/Serialization/TypeSpecOperationResponseHeaderConverter.cs @@ -29,14 +29,16 @@ private OperationResponseHeader CreateOperationResponseHeader(ref Utf8JsonReader var isFirstProperty = id == null; string? name = null; string? nameInResponse = null; - string? description = null; + string? summary = null; + string? doc = null; InputType? type = null; while (reader.TokenType != JsonTokenType.EndObject) { var isKnownProperty = reader.TryReadReferenceId(ref isFirstProperty, ref id) || reader.TryReadString(nameof(OperationResponseHeader.Name), ref name) || reader.TryReadString(nameof(OperationResponseHeader.NameInResponse), ref nameInResponse) - || reader.TryReadString(nameof(OperationResponseHeader.Description), ref description) + || reader.TryReadString("Summary", ref summary) + || reader.TryReadString("Doc", ref doc) || reader.TryReadWithConverter(nameof(OperationResponseHeader.Type), options, ref type); if (!isKnownProperty) @@ -47,10 +49,9 @@ private OperationResponseHeader CreateOperationResponseHeader(ref Utf8JsonReader name = name ?? throw new JsonException("OperationResponseHeader must have Name"); nameInResponse = nameInResponse ?? throw new JsonException("OperationResponseHeader must have NameInResponse"); - description = description ?? string.Empty; type = type ?? throw new JsonException("OperationResponseHeader must have Type"); - var result = new OperationResponseHeader(name, nameInResponse, description, type); + var result = new OperationResponseHeader(name, nameInResponse, summary, doc, type); if (id != null) { diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/perf/CodeWriterBenchmark.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/perf/CodeWriterBenchmark.cs index d0c992d5e6..4fe0617718 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/perf/CodeWriterBenchmark.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/perf/CodeWriterBenchmark.cs @@ -19,9 +19,9 @@ public CodeWriterBenchmark() PluginInitializer.Initialize(); var properties = new[] { - new InputModelProperty("MyProperty", "myProperty", "The property of mine", InputPrimitiveType.Int32, true, false, false) + new InputModelProperty("MyProperty", "myProperty", null, "The property of mine", InputPrimitiveType.Int32, true, false, false) }; - var inputModel = new InputModelType("MyModel", string.Empty, null, null, "Test model", InputModelTypeUsage.Input | InputModelTypeUsage.Output, properties, null, Array.Empty(), null, null, new Dictionary(), null, false); + var inputModel = new InputModelType("MyModel", string.Empty, null, null, null, "Test model", InputModelTypeUsage.Input | InputModelTypeUsage.Output, properties, null, Array.Empty(), null, null, new Dictionary(), null, false); var modelProvider = new ModelProvider(inputModel); _writer = new TypeProviderWriter(modelProvider); } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/EnumProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/EnumProvider.cs index f0418c0980..c7d34c1667 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/EnumProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/EnumProvider.cs @@ -5,6 +5,7 @@ using System.IO; using Microsoft.Generator.CSharp.Input; using Microsoft.Generator.CSharp.Primitives; +using Microsoft.Generator.CSharp.Utilities; namespace Microsoft.Generator.CSharp.Providers { @@ -33,7 +34,7 @@ protected EnumProvider(InputEnumType input) _inputType = input; _deprecated = input.Deprecated; IsExtensible = input.IsExtensible; - Description = input.Description != null ? FormattableStringHelpers.FromString(input.Description) : $"The {Name}."; + Description = DocHelpers.GetFormattableDescription(input.Summary, input.Doc) ?? FormattableStringHelpers.Empty; } public bool IsExtensible { get; } diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ExtensibleEnumProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ExtensibleEnumProvider.cs index 9f9c39f84b..b361f04bb2 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ExtensibleEnumProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ExtensibleEnumProvider.cs @@ -11,6 +11,7 @@ using Microsoft.Generator.CSharp.Primitives; using Microsoft.Generator.CSharp.Snippets; using Microsoft.Generator.CSharp.Statements; +using Microsoft.Generator.CSharp.Utilities; using static Microsoft.Generator.CSharp.Snippets.Snippet; namespace Microsoft.Generator.CSharp.Providers @@ -59,7 +60,7 @@ protected override IReadOnlyList BuildEnumValues() EnumUnderlyingType, name, this, - FormattableStringHelpers.FromString(inputValue.Description), + DocHelpers.GetFormattableDescription(inputValue.Summary, inputValue.Doc), initializationValue); values[i] = new EnumTypeMember(valueName, field, inputValue.Value); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/FixedEnumProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/FixedEnumProvider.cs index 1a3fd8b783..8ee32d9030 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/FixedEnumProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/FixedEnumProvider.cs @@ -8,6 +8,7 @@ using Microsoft.Generator.CSharp.Input; using Microsoft.Generator.CSharp.Primitives; using Microsoft.Generator.CSharp.SourceInput; +using Microsoft.Generator.CSharp.Utilities; using static Microsoft.Generator.CSharp.Snippets.Snippet; namespace Microsoft.Generator.CSharp.Providers @@ -98,7 +99,7 @@ protected override IReadOnlyList BuildEnumValues() EnumUnderlyingType, name, this, - inputValue.Description is null ? $"{name}" : FormattableStringHelpers.FromString(inputValue.Description), + DocHelpers.GetFormattableDescription(inputValue.Summary, inputValue.Doc) ?? $"{name}", initializationValue); values[i] = new EnumTypeMember(name, field, inputValue.Value); diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ModelProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ModelProvider.cs index 57c3751751..f86c2a547e 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ModelProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ModelProvider.cs @@ -10,6 +10,7 @@ using Microsoft.Generator.CSharp.Primitives; using Microsoft.Generator.CSharp.Snippets; using Microsoft.Generator.CSharp.Statements; +using Microsoft.Generator.CSharp.Utilities; using static Microsoft.Generator.CSharp.Snippets.Snippet; namespace Microsoft.Generator.CSharp.Providers @@ -33,7 +34,7 @@ public sealed class ModelProvider : TypeProvider public ModelProvider(InputModelType inputModel) : base(inputModel) { _inputModel = inputModel; - Description = inputModel.Description != null ? FormattableStringHelpers.FromString(inputModel.Description) : $"The {Name}."; + Description = DocHelpers.GetFormattableDescription(inputModel.Summary, inputModel.Doc) ?? $"The {Name}."; if (inputModel.BaseModel is not null) { diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ParameterProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ParameterProvider.cs index 96aaea74d9..8f068430fd 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ParameterProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/ParameterProvider.cs @@ -11,6 +11,7 @@ using Microsoft.Generator.CSharp.Primitives; using Microsoft.Generator.CSharp.Snippets; using Microsoft.Generator.CSharp.Statements; +using Microsoft.Generator.CSharp.Utilities; namespace Microsoft.Generator.CSharp.Providers { @@ -50,7 +51,7 @@ public sealed class ParameterProvider : IEquatable public ParameterProvider(InputParameter inputParameter) { Name = inputParameter.Name; - Description = FormattableStringHelpers.FromString(inputParameter.Description) ?? FormattableStringHelpers.Empty; + Description = DocHelpers.GetFormattableDescription(inputParameter.Summary, inputParameter.Doc) ?? FormattableStringHelpers.Empty; var type = CodeModelPlugin.Instance.TypeFactory.CreateCSharpType(inputParameter.Type) ?? throw new InvalidOperationException($"Failed to create CSharpType for {inputParameter.Type}"); if (!inputParameter.IsRequired && !type.IsCollection) { diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/PropertyProvider.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/PropertyProvider.cs index 3add49825d..d940fcfb22 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/PropertyProvider.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Providers/PropertyProvider.cs @@ -9,6 +9,7 @@ using Microsoft.Generator.CSharp.Primitives; using Microsoft.Generator.CSharp.Snippets; using Microsoft.Generator.CSharp.Statements; +using Microsoft.Generator.CSharp.Utilities; namespace Microsoft.Generator.CSharp.Providers { @@ -89,13 +90,13 @@ private PropertyProvider(InputModelProperty inputProperty, CSharpType propertyTy ? $"{inputProperty.Name.ToCleanName()}Property" : inputProperty.Name.ToCleanName(); Body = new AutoPropertyBody(propHasSetter, setterModifier, GetPropertyInitializationValue(propertyType, inputProperty)); - Description = string.IsNullOrEmpty(inputProperty.Description) ? PropertyDescriptionBuilder.CreateDefaultPropertyDescription(Name, !Body.HasSetter) : $"{inputProperty.Description}"; + Description = DocHelpers.GetFormattableDescription(inputProperty.Summary, inputProperty.Doc) ?? PropertyDescriptionBuilder.CreateDefaultPropertyDescription(Name, !Body.HasSetter); XmlDocSummary = PropertyDescriptionBuilder.BuildPropertyDescription(inputProperty, propertyType, serializationFormat, Description); XmlDocs = GetXmlDocs(); WireInfo = new PropertyWireInformation(inputProperty); IsDiscriminator = inputProperty.IsDiscriminator; - InitializeParameter(FormattableStringHelpers.FromString(inputProperty.Description) ?? FormattableStringHelpers.Empty); + InitializeParameter(DocHelpers.GetFormattableDescription(inputProperty.Summary, inputProperty.Doc) ?? FormattableStringHelpers.Empty); } public PropertyProvider( diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Utilities/DocHelpers.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Utilities/DocHelpers.cs new file mode 100644 index 0000000000..54b8ee4e70 --- /dev/null +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/src/Utilities/DocHelpers.cs @@ -0,0 +1,25 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +using System; + +namespace Microsoft.Generator.CSharp.Utilities +{ + public class DocHelpers + { + public static string? GetDescription(string? summary, string? doc) + { + return (summary, doc) switch + { + (null or "", null or "") => null, + (string s, null or "") => s, + _ => doc, + }; + } + + public static FormattableString? GetFormattableDescription(string? summary, string? doc) + { + return FormattableStringHelpers.FromString(GetDescription(summary, doc)); + } + } +} diff --git a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/test/common/InputFactory.cs b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/test/common/InputFactory.cs index ab744e62e9..377a9c3c63 100644 --- a/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/test/common/InputFactory.cs +++ b/packages/http-client-csharp/generator/Microsoft.Generator.CSharp/test/common/InputFactory.cs @@ -13,17 +13,17 @@ public static class EnumMember { public static InputEnumTypeValue Int32(string name, int value) { - return new InputEnumTypeValue(name, value, InputPrimitiveType.Int32, $"{name} description"); + return new InputEnumTypeValue(name, value, InputPrimitiveType.Int32, "", $"{name} description"); } public static InputEnumTypeValue Float32(string name, float value) { - return new InputEnumTypeValue(name, value, InputPrimitiveType.Float32, $"{name} description"); + return new InputEnumTypeValue(name, value, InputPrimitiveType.Float32, "", $"{name} description"); } public static InputEnumTypeValue String(string name, string value) { - return new InputEnumTypeValue(name, value, InputPrimitiveType.String, $"{name} description"); + return new InputEnumTypeValue(name, value, InputPrimitiveType.String, "", $"{name} description"); } } @@ -87,6 +87,7 @@ public static InputParameter Parameter( return new InputParameter( name, nameInRequest ?? name, + "", $"{name} description", type, location, @@ -131,10 +132,11 @@ public static InputEnumType Enum( name, access, null, + "", $"{name} description", usage, underlyingType, - values is null ? [new InputEnumTypeValue("Value", 1, InputPrimitiveType.Int32, "Value description")] : [.. values], + values is null ? [new InputEnumTypeValue("Value", 1, InputPrimitiveType.Int32, "", "Value description")] : [.. values], isExtensible); } @@ -145,12 +147,14 @@ public static InputModelProperty Property( bool isReadOnly = false, bool isDiscriminator = false, string? wireName = null, - string? description = null) + string? summary = null, + string? doc = null) { return new InputModelProperty( name, wireName ?? name.ToVariableName(), - description ?? $"Description for {name}", + summary, + doc ?? $"Description for {name}", type, isRequired, isReadOnly, @@ -175,6 +179,7 @@ public static InputModelType Model( name, access, null, + "", $"{name} description", usage, [.. propertiesList], @@ -215,6 +220,7 @@ public static InputOperation Operation( return new InputOperation( name, null, + "", $"{name} description", null, access, @@ -249,6 +255,7 @@ public static InputClient Client(string name, IEnumerable? opera { return new InputClient( name, + "", $"{name} description", operations is null ? [] : [.. operations], parameters is null ? [] : [.. parameters], diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/api-key/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/api-key/tspCodeModel.json index e482e7e3f6..ef0de4c6a0 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/api-key/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/api-key/tspCodeModel.json @@ -38,13 +38,13 @@ { "$id": "5", "Name": "ApiKeyClient", - "Description": "Illustrates clients generated with ApiKey authentication.", + "Doc": "Illustrates clients generated with ApiKey authentication.", "Operations": [ { "$id": "6", "Name": "valid", "ResourceName": "ApiKey", - "Description": "Check whether client is authenticated", + "Doc": "Check whether client is authenticated", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -72,7 +72,7 @@ "$id": "8", "Name": "invalid", "ResourceName": "ApiKey", - "Description": "Check whether client is authenticated.", + "Doc": "Check whether client is authenticated.", "Accessibility": "public", "Parameters": [ { @@ -133,7 +133,7 @@ "$id": "14", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "15", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/http/custom/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/http/custom/tspCodeModel.json index d3581f4452..66a0b73463 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/http/custom/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/http/custom/tspCodeModel.json @@ -38,13 +38,13 @@ { "$id": "5", "Name": "CustomClient", - "Description": "Illustrates clients generated with generic HTTP auth.", + "Doc": "Illustrates clients generated with generic HTTP auth.", "Operations": [ { "$id": "6", "Name": "valid", "ResourceName": "Custom", - "Description": "Check whether client is authenticated", + "Doc": "Check whether client is authenticated", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -72,7 +72,7 @@ "$id": "8", "Name": "invalid", "ResourceName": "Custom", - "Description": "Check whether client is authenticated.", + "Doc": "Check whether client is authenticated.", "Accessibility": "public", "Parameters": [ { @@ -133,7 +133,7 @@ "$id": "14", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "15", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/oauth2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/oauth2/tspCodeModel.json index 58548e8802..f850eca7f7 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/oauth2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/oauth2/tspCodeModel.json @@ -38,13 +38,13 @@ { "$id": "5", "Name": "OAuth2Client", - "Description": "Illustrates clients generated with OAuth2 authentication.", + "Doc": "Illustrates clients generated with OAuth2 authentication.", "Operations": [ { "$id": "6", "Name": "valid", "ResourceName": "OAuth2", - "Description": "Check whether client is authenticated", + "Doc": "Check whether client is authenticated", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -72,7 +72,7 @@ "$id": "8", "Name": "invalid", "ResourceName": "OAuth2", - "Description": "Check whether client is authenticated. Will return an invalid bearer error.", + "Doc": "Check whether client is authenticated. Will return an invalid bearer error.", "Accessibility": "public", "Parameters": [ { @@ -133,7 +133,7 @@ "$id": "14", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "15", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/union/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/union/tspCodeModel.json index 8871b5313b..a45094e11e 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/union/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/authentication/union/tspCodeModel.json @@ -8,13 +8,13 @@ { "$id": "2", "Name": "UnionClient", - "Description": "Illustrates clients generated with ApiKey and OAuth2 authentication.", + "Doc": "Illustrates clients generated with ApiKey and OAuth2 authentication.", "Operations": [ { "$id": "3", "Name": "validKey", "ResourceName": "Union", - "Description": "Check whether client is authenticated", + "Doc": "Check whether client is authenticated", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -42,7 +42,7 @@ "$id": "5", "Name": "validToken", "ResourceName": "Union", - "Description": "Check whether client is authenticated", + "Doc": "Check whether client is authenticated", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -75,7 +75,7 @@ "$id": "8", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "9", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/naming/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/naming/tspCodeModel.json index 9dd12ec66c..b45cd859a4 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/naming/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/naming/tspCodeModel.json @@ -107,7 +107,7 @@ "kind": "property", "name": "clientName", "serializedName": "defaultName", - "description": "Pass in true", + "doc": "Pass in true", "type": { "$id": "14", "kind": "boolean", @@ -137,7 +137,7 @@ "kind": "property", "name": "CSName", "serializedName": "defaultName", - "description": "Pass in true", + "doc": "Pass in true", "type": { "$id": "17", "kind": "boolean", @@ -167,7 +167,7 @@ "kind": "property", "name": "clientName", "serializedName": "wireName", - "description": "Pass in true", + "doc": "Pass in true", "type": { "$id": "20", "kind": "boolean", @@ -197,7 +197,7 @@ "kind": "property", "name": "defaultName", "serializedName": "defaultName", - "description": "Pass in true", + "doc": "Pass in true", "type": { "$id": "23", "kind": "boolean", @@ -227,7 +227,7 @@ "kind": "property", "name": "defaultName", "serializedName": "defaultName", - "description": "Pass in true", + "doc": "Pass in true", "type": { "$id": "26", "kind": "boolean", @@ -249,7 +249,7 @@ { "$id": "27", "Name": "NamingClient", - "Description": "Describe changing names of types in a client with `@clientName`", + "Doc": "Describe changing names of types in a client with `@clientName`", "Operations": [ { "$id": "28", @@ -337,7 +337,7 @@ "$id": "35", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "36", "kind": "constant", @@ -413,7 +413,7 @@ "$id": "41", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "42", "kind": "constant", @@ -489,7 +489,7 @@ "$id": "47", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "48", "kind": "constant", @@ -653,7 +653,7 @@ "$id": "61", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "62", "kind": "url", @@ -697,7 +697,7 @@ "$id": "67", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "68", "kind": "constant", @@ -773,7 +773,7 @@ "$id": "73", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "74", "kind": "constant", @@ -849,7 +849,7 @@ "$id": "79", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "80", "kind": "url", @@ -893,7 +893,7 @@ "$id": "85", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "86", "kind": "constant", @@ -969,7 +969,7 @@ "$id": "91", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "92", "kind": "constant", @@ -1045,7 +1045,7 @@ "$id": "97", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "98", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/client-operation-group/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/client-operation-group/tspCodeModel.json index b9cf9bc3ed..84895c53c2 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/client-operation-group/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/client-operation-group/tspCodeModel.json @@ -150,7 +150,7 @@ "$id": "18", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "19", "kind": "url", @@ -171,7 +171,7 @@ "$id": "20", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -256,7 +256,7 @@ "$id": "27", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "28", "kind": "url", @@ -277,7 +277,7 @@ "$id": "29", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -335,7 +335,7 @@ "$id": "34", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "35", "kind": "url", @@ -356,7 +356,7 @@ "$id": "36", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -413,7 +413,7 @@ "$id": "41", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "42", "kind": "url", @@ -434,7 +434,7 @@ "$id": "43", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -492,7 +492,7 @@ "$id": "48", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "49", "kind": "url", @@ -513,7 +513,7 @@ "$id": "50", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/default/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/default/tspCodeModel.json index cb970749db..a96d186132 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/default/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/default/tspCodeModel.json @@ -113,7 +113,7 @@ { "$id": "14", "Name": "ServiceClient", - "Description": "Test that we can use @client and @operationGroup decorators to customize client side code structure, such as:\n1. have everything as default.\n2. to rename client or operation group\n3. one client can have more than one operations groups\n4. split one interface into two clients\n5. have two clients with operations come from different interfaces\n6. have two clients with a hierarchy relation.", + "Doc": "Test that we can use @client and @operationGroup decorators to customize client side code structure, such as:\n1. have everything as default.\n2. to rename client or operation group\n3. one client can have more than one operations groups\n4. split one interface into two clients\n5. have two clients with operations come from different interfaces\n6. have two clients with a hierarchy relation.", "Operations": [ { "$id": "15", @@ -178,7 +178,7 @@ "$id": "20", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "21", "kind": "url", @@ -199,7 +199,7 @@ "$id": "22", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -229,7 +229,7 @@ "$id": "25", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "26", "kind": "url", @@ -250,7 +250,7 @@ "$id": "27", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -308,7 +308,7 @@ "$id": "32", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "33", "kind": "url", @@ -329,7 +329,7 @@ "$id": "34", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -387,7 +387,7 @@ "$id": "39", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "40", "kind": "url", @@ -408,7 +408,7 @@ "$id": "41", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -466,7 +466,7 @@ "$id": "46", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "47", "kind": "url", @@ -487,7 +487,7 @@ "$id": "48", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -572,7 +572,7 @@ "$id": "55", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "56", "kind": "url", @@ -593,7 +593,7 @@ "$id": "57", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -678,7 +678,7 @@ "$id": "64", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "65", "kind": "url", @@ -699,7 +699,7 @@ "$id": "66", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/multi-client/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/multi-client/tspCodeModel.json index 1cc4669fc8..5cf7a1ba21 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/multi-client/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/multi-client/tspCodeModel.json @@ -204,7 +204,7 @@ "$id": "22", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "23", "kind": "url", @@ -225,7 +225,7 @@ "$id": "24", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -336,7 +336,7 @@ "$id": "33", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "34", "kind": "url", @@ -357,7 +357,7 @@ "$id": "35", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/renamed-operation/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/renamed-operation/tspCodeModel.json index 3a0f6751fa..bf93610953 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/renamed-operation/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/renamed-operation/tspCodeModel.json @@ -204,7 +204,7 @@ "$id": "22", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "23", "kind": "url", @@ -225,7 +225,7 @@ "$id": "24", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -337,7 +337,7 @@ "$id": "33", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "34", "kind": "url", @@ -358,7 +358,7 @@ "$id": "35", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/two-operation-group/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/two-operation-group/tspCodeModel.json index ac9645a8d8..3d6903520a 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/two-operation-group/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/client/structure/two-operation-group/tspCodeModel.json @@ -122,7 +122,7 @@ "$id": "16", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "17", "kind": "url", @@ -143,7 +143,7 @@ "$id": "18", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -255,7 +255,7 @@ "$id": "27", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "28", "kind": "url", @@ -276,7 +276,7 @@ "$id": "29", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, @@ -388,7 +388,7 @@ "$id": "38", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "39", "kind": "url", @@ -409,7 +409,7 @@ "$id": "40", "Name": "client", "NameInRequest": "client", - "Description": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", + "Doc": "Need to be set as 'default', 'multi-client', 'renamed-operation', 'two-operation-group' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/bytes/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/bytes/tspCodeModel.json index f872e1854d..bdd59c6d28 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/bytes/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/bytes/tspCodeModel.json @@ -144,7 +144,7 @@ { "$id": "16", "Name": "BytesClient", - "Description": "Test for encode decorator on bytes.", + "Doc": "Test for encode decorator on bytes.", "Operations": [], "Protocol": { "$id": "17" @@ -154,7 +154,7 @@ "$id": "18", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "19", "kind": "url", @@ -414,7 +414,7 @@ "$id": "42", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "43", "kind": "url", @@ -458,7 +458,7 @@ "$id": "48", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "49", "kind": "constant", @@ -567,7 +567,7 @@ "$id": "57", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "58", "kind": "constant", @@ -676,7 +676,7 @@ "$id": "66", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "67", "kind": "constant", @@ -785,7 +785,7 @@ "$id": "75", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "76", "kind": "constant", @@ -894,7 +894,7 @@ "$id": "84", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "85", "kind": "url", @@ -1154,7 +1154,7 @@ "$id": "108", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "109", "kind": "url", @@ -1198,7 +1198,7 @@ "$id": "114", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "115", "kind": "constant", @@ -1437,7 +1437,7 @@ "$id": "135", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "136", "kind": "constant", @@ -1518,7 +1518,7 @@ "$id": "142", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "143", "kind": "constant", @@ -1599,7 +1599,7 @@ "$id": "149", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "150", "kind": "url", @@ -2017,7 +2017,7 @@ "$id": "192", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "193", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/datetime/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/datetime/tspCodeModel.json index 36ee372f31..bc8c2b51a1 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/datetime/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/datetime/tspCodeModel.json @@ -216,7 +216,7 @@ { "$id": "25", "Name": "DatetimeClient", - "Description": "Test for encode decorator on datetime.", + "Doc": "Test for encode decorator on datetime.", "Operations": [], "Protocol": { "$id": "26" @@ -226,7 +226,7 @@ "$id": "27", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "28", "kind": "url", @@ -578,7 +578,7 @@ "$id": "61", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "62", "kind": "url", @@ -622,7 +622,7 @@ "$id": "67", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "68", "kind": "constant", @@ -731,7 +731,7 @@ "$id": "76", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "77", "kind": "constant", @@ -840,7 +840,7 @@ "$id": "85", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "86", "kind": "constant", @@ -949,7 +949,7 @@ "$id": "94", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "95", "kind": "constant", @@ -1058,7 +1058,7 @@ "$id": "103", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "104", "kind": "constant", @@ -1167,7 +1167,7 @@ "$id": "112", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "113", "kind": "url", @@ -1519,7 +1519,7 @@ "$id": "146", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "147", "kind": "url", @@ -1755,7 +1755,7 @@ "$id": "172", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "173", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/duration/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/duration/tspCodeModel.json index f260fca7a3..3d0c5af0ec 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/duration/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/duration/tspCodeModel.json @@ -253,7 +253,7 @@ { "$id": "29", "Name": "DurationClient", - "Description": "Test for encode decorator on duration.", + "Doc": "Test for encode decorator on duration.", "Operations": [], "Protocol": { "$id": "30" @@ -263,7 +263,7 @@ "$id": "31", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "32", "kind": "url", @@ -672,7 +672,7 @@ "$id": "70", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "71", "kind": "url", @@ -716,7 +716,7 @@ "$id": "76", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "77", "kind": "constant", @@ -825,7 +825,7 @@ "$id": "85", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "86", "kind": "constant", @@ -934,7 +934,7 @@ "$id": "94", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "95", "kind": "constant", @@ -1043,7 +1043,7 @@ "$id": "103", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "104", "kind": "constant", @@ -1152,7 +1152,7 @@ "$id": "112", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "113", "kind": "constant", @@ -1261,7 +1261,7 @@ "$id": "121", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "122", "kind": "constant", @@ -1370,7 +1370,7 @@ "$id": "130", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "131", "kind": "url", @@ -1779,7 +1779,7 @@ "$id": "169", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "170", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/numeric/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/numeric/tspCodeModel.json index f22f89ca1a..332008506d 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/numeric/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/encode/numeric/tspCodeModel.json @@ -99,7 +99,7 @@ { "$id": "11", "Name": "NumericClient", - "Description": "Test for encode decorator on integer.", + "Doc": "Test for encode decorator on integer.", "Operations": [], "Protocol": { "$id": "12" @@ -109,7 +109,7 @@ "$id": "13", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "14", "kind": "url", @@ -153,7 +153,7 @@ "$id": "19", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "20", "kind": "constant", @@ -262,7 +262,7 @@ "$id": "28", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "29", "kind": "constant", @@ -371,7 +371,7 @@ "$id": "37", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "38", "kind": "constant", @@ -480,7 +480,7 @@ "$id": "46", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "47", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/basic/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/basic/tspCodeModel.json index 497d8c7a53..08a2175e23 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/basic/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/basic/tspCodeModel.json @@ -39,7 +39,7 @@ "name": "User", "crossLanguageDefinitionId": "Parameters.Basic.ExplicitBody.User", "usage": "Input,Json", - "description": "This is a simple model.", + "doc": "This is a simple model.", "decorators": [], "properties": [ { @@ -68,7 +68,7 @@ { "$id": "8", "Name": "BasicClient", - "Description": "Test for basic parameters cases.", + "Doc": "Test for basic parameters cases.", "Operations": [], "Protocol": { "$id": "9" @@ -78,7 +78,7 @@ "$id": "10", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "11", "kind": "url", @@ -122,7 +122,7 @@ "$id": "16", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "17", "kind": "constant", @@ -198,7 +198,7 @@ "$id": "22", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "23", "kind": "url", @@ -242,7 +242,7 @@ "$id": "28", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "29", "kind": "constant", @@ -318,7 +318,7 @@ "$id": "34", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "35", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/body-optionality/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/body-optionality/tspCodeModel.json index b67afd40a9..8339a4a06c 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/body-optionality/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/body-optionality/tspCodeModel.json @@ -38,7 +38,7 @@ { "$id": "5", "Name": "BodyOptionalityClient", - "Description": "Test describing optionality of the request body.", + "Doc": "Test describing optionality of the request body.", "Operations": [ { "$id": "6", @@ -50,7 +50,7 @@ "$id": "7", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "8", "kind": "constant", @@ -126,7 +126,7 @@ "$id": "13", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "14", "kind": "constant", @@ -201,7 +201,7 @@ "$id": "19", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "20", "kind": "url", @@ -245,7 +245,7 @@ "$id": "25", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "26", "kind": "constant", @@ -321,7 +321,7 @@ "$id": "31", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "32", "kind": "constant", @@ -397,7 +397,7 @@ "$id": "37", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "38", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/collection-format/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/collection-format/tspCodeModel.json index 28a3f46e99..f0c002b4d9 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/collection-format/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/collection-format/tspCodeModel.json @@ -8,7 +8,7 @@ { "$id": "2", "Name": "CollectionFormatClient", - "Description": "Test for collectionFormat.", + "Doc": "Test for collectionFormat.", "Operations": [], "Protocol": { "$id": "3" @@ -18,7 +18,7 @@ "$id": "4", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "5", "kind": "url", @@ -62,7 +62,7 @@ "$id": "10", "Name": "colors", "NameInRequest": "colors", - "Description": "Possible values for colors are [blue,red,green]", + "Doc": "Possible values for colors are [blue,red,green]", "Type": { "$id": "11", "kind": "array", @@ -119,7 +119,7 @@ "$id": "15", "Name": "colors", "NameInRequest": "colors", - "Description": "Possible values for colors are [blue,red,green]", + "Doc": "Possible values for colors are [blue,red,green]", "Type": { "$id": "16", "kind": "array", @@ -177,7 +177,7 @@ "$id": "20", "Name": "colors", "NameInRequest": "colors", - "Description": "Possible values for colors are [blue,red,green]", + "Doc": "Possible values for colors are [blue,red,green]", "Type": { "$id": "21", "kind": "array", @@ -235,7 +235,7 @@ "$id": "25", "Name": "colors", "NameInRequest": "colors", - "Description": "Possible values for colors are [blue,red,green]", + "Doc": "Possible values for colors are [blue,red,green]", "Type": { "$id": "26", "kind": "array", @@ -293,7 +293,7 @@ "$id": "30", "Name": "colors", "NameInRequest": "colors", - "Description": "Possible values for colors are [blue,red,green]", + "Doc": "Possible values for colors are [blue,red,green]", "Type": { "$id": "31", "kind": "array", @@ -351,7 +351,7 @@ "$id": "35", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "36", "kind": "url", @@ -395,7 +395,7 @@ "$id": "41", "Name": "colors", "NameInRequest": "colors", - "Description": "Possible values for colors are [blue,red,green]", + "Doc": "Possible values for colors are [blue,red,green]", "Type": { "$id": "42", "kind": "array", @@ -453,7 +453,7 @@ "$id": "46", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "47", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/spread/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/spread/tspCodeModel.json index 3cc532ba73..f750112b2b 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/spread/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/parameters/spread/tspCodeModel.json @@ -104,7 +104,7 @@ "kind": "property", "name": "requiredString", "serializedName": "requiredString", - "description": "required string", + "doc": "required string", "type": { "$id": "13", "kind": "string", @@ -124,7 +124,7 @@ "kind": "property", "name": "optionalInt", "serializedName": "optionalInt", - "description": "optional int", + "doc": "optional int", "type": { "$id": "15", "kind": "int32", @@ -144,7 +144,7 @@ "kind": "property", "name": "requiredIntList", "serializedName": "requiredIntList", - "description": "required int", + "doc": "required int", "type": { "$id": "17", "kind": "array", @@ -171,7 +171,7 @@ "kind": "property", "name": "optionalStringList", "serializedName": "optionalStringList", - "description": "optional string", + "doc": "optional string", "type": { "$id": "20", "kind": "array", @@ -208,7 +208,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "name of the Thing", + "doc": "name of the Thing", "type": { "$id": "24", "kind": "string", @@ -228,7 +228,7 @@ "kind": "property", "name": "age", "serializedName": "age", - "description": "age of the Thing", + "doc": "age of the Thing", "type": { "$id": "26", "kind": "int32", @@ -251,7 +251,7 @@ "name": "BodyParameter", "crossLanguageDefinitionId": "Parameters.Spread.Model.BodyParameter", "usage": "Input,Spread,Json", - "description": "This is a simple model.", + "doc": "This is a simple model.", "decorators": [], "properties": [ { @@ -309,7 +309,7 @@ { "$id": "33", "Name": "SpreadClient", - "Description": "Test for the spread operator.", + "Doc": "Test for the spread operator.", "Operations": [], "Protocol": { "$id": "34" @@ -319,7 +319,7 @@ "$id": "35", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "36", "kind": "url", @@ -363,7 +363,7 @@ "$id": "41", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "42", "kind": "constant", @@ -439,7 +439,7 @@ "$id": "47", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "48", "kind": "constant", @@ -627,7 +627,7 @@ "$id": "63", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "64", "kind": "constant", @@ -745,7 +745,7 @@ "$id": "73", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "74", "kind": "constant", @@ -821,7 +821,7 @@ "$id": "79", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "80", "kind": "url", @@ -865,7 +865,7 @@ "$id": "85", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "86", "kind": "constant", @@ -983,7 +983,7 @@ "$id": "95", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "96", "kind": "constant", @@ -1101,7 +1101,7 @@ "$id": "105", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "106", "kind": "constant", @@ -1219,7 +1219,7 @@ "$id": "115", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "116", "kind": "constant", @@ -1289,7 +1289,7 @@ "$id": "120", "Name": "spreadParameterWithInnerAlias", "ResourceName": "Alias", - "Description": "spread an alias with contains another alias property as body.", + "Doc": "spread an alias with contains another alias property as body.", "Accessibility": "public", "Parameters": [ { @@ -1338,7 +1338,7 @@ "$id": "125", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "126", "kind": "constant", @@ -1414,7 +1414,7 @@ "$id": "131", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "132", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/content-negotiation/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/content-negotiation/tspCodeModel.json index 3e9be3f530..1f299606a5 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/content-negotiation/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/content-negotiation/tspCodeModel.json @@ -39,7 +39,7 @@ { "$id": "5", "Name": "ContentNegotiationClient", - "Description": "Test describing optionality of the request body.", + "Doc": "Test describing optionality of the request body.", "Operations": [], "Protocol": { "$id": "6" @@ -49,7 +49,7 @@ "$id": "7", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "8", "kind": "url", @@ -261,7 +261,7 @@ "$id": "31", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "32", "kind": "url", @@ -469,7 +469,7 @@ "$id": "54", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "55", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/json-merge-patch/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/json-merge-patch/tspCodeModel.json index ba4f5d41db..c24d9ec960 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/json-merge-patch/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/json-merge-patch/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "Resource", "crossLanguageDefinitionId": "Payload.JsonMergePatch.Resource", "usage": "Input,Output,Json", - "description": "Details about a resource.", + "doc": "Details about a resource.", "decorators": [], "properties": [ { @@ -72,7 +72,7 @@ "name": "InnerModel", "crossLanguageDefinitionId": "Payload.JsonMergePatch.InnerModel", "usage": "Input,Output,JsonMergePatch,Json", - "description": "It is the model used by Resource model", + "doc": "It is the model used by Resource model", "decorators": [], "properties": [ { @@ -236,7 +236,7 @@ "name": "ResourcePatch", "crossLanguageDefinitionId": "Payload.JsonMergePatch.ResourcePatch", "usage": "Input,JsonMergePatch,Json", - "description": "Details about a resource for patch operation.", + "doc": "Details about a resource for patch operation.", "decorators": [], "properties": [ { @@ -393,20 +393,20 @@ { "$id": "41", "Name": "JsonMergePatchClient", - "Description": "Test for merge-patch+json content-type", + "Doc": "Test for merge-patch+json content-type", "Operations": [ { "$id": "42", "Name": "createResource", "ResourceName": "JsonMergePatch", - "Description": "Test content-type: application/merge-patch+json with required body", + "Doc": "Test content-type: application/merge-patch+json with required body", "Accessibility": "public", "Parameters": [ { "$id": "43", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "44", "kind": "constant", @@ -509,7 +509,7 @@ "$id": "51", "Name": "updateResource", "ResourceName": "JsonMergePatch", - "Description": "Test content-type: application/merge-patch+json with required body", + "Doc": "Test content-type: application/merge-patch+json with required body", "Accessibility": "public", "Parameters": [ { @@ -618,7 +618,7 @@ "$id": "60", "Name": "updateOptionalResource", "ResourceName": "JsonMergePatch", - "Description": "Test content-type: application/merge-patch+json with optional body", + "Doc": "Test content-type: application/merge-patch+json with optional body", "Accessibility": "public", "Parameters": [ { @@ -732,7 +732,7 @@ "$id": "70", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "71", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/media-type/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/media-type/tspCodeModel.json index 3fb458ca14..9bc86bebe4 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/media-type/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/media-type/tspCodeModel.json @@ -8,7 +8,7 @@ { "$id": "2", "Name": "MediaTypeClient", - "Description": "Test the payload with different media types and different types of the payload itself.", + "Doc": "Test the payload with different media types and different types of the payload itself.", "Operations": [], "Protocol": { "$id": "3" @@ -18,7 +18,7 @@ "$id": "4", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "5", "kind": "url", @@ -388,7 +388,7 @@ "$id": "42", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "43", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/multipart/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/multipart/tspCodeModel.json index cfc7d5e279..f134fc4e36 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/multipart/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/payload/multipart/tspCodeModel.json @@ -20,7 +20,7 @@ "kind": "enumvalue", "name": "image/jpg", "value": "image/jpg", - "description": "image/jpg", + "doc": "image/jpg", "valueType": { "$ref": "3" }, @@ -30,7 +30,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The FileSpecificContentType_contentType", + "doc": "The FileSpecificContentType_contentType", "isFixed": false, "isFlags": false, "usage": "Input", @@ -813,7 +813,7 @@ { "$id": "79", "Name": "MultiPartClient", - "Description": "Test for multipart", + "Doc": "Test for multipart", "Operations": [], "Protocol": { "$id": "80" @@ -823,7 +823,7 @@ "$id": "81", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "82", "kind": "url", @@ -861,7 +861,7 @@ "$id": "86", "Name": "basic", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data", + "Doc": "Test content-type: multipart/form-data", "Accessibility": "public", "Parameters": [ { @@ -937,7 +937,7 @@ "$id": "92", "Name": "fileArrayAndBasic", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data for mixed scenarios", + "Doc": "Test content-type: multipart/form-data for mixed scenarios", "Accessibility": "public", "Parameters": [ { @@ -1013,7 +1013,7 @@ "$id": "98", "Name": "jsonPart", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data for scenario contains json part and binary part ", + "Doc": "Test content-type: multipart/form-data for scenario contains json part and binary part ", "Accessibility": "public", "Parameters": [ { @@ -1089,7 +1089,7 @@ "$id": "104", "Name": "binaryArrayParts", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data for scenario contains multi binary parts", + "Doc": "Test content-type: multipart/form-data for scenario contains multi binary parts", "Accessibility": "public", "Parameters": [ { @@ -1165,7 +1165,7 @@ "$id": "110", "Name": "multiBinaryParts", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data for scenario contains multi binary parts", + "Doc": "Test content-type: multipart/form-data for scenario contains multi binary parts", "Accessibility": "public", "Parameters": [ { @@ -1241,7 +1241,7 @@ "$id": "116", "Name": "checkFileNameAndContentType", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data", + "Doc": "Test content-type: multipart/form-data", "Accessibility": "public", "Parameters": [ { @@ -1317,7 +1317,7 @@ "$id": "122", "Name": "anonymousModel", "ResourceName": "FormData", - "Description": "Test content-type: multipart/form-data", + "Doc": "Test content-type: multipart/form-data", "Accessibility": "public", "Parameters": [ { @@ -1399,7 +1399,7 @@ "$id": "129", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "130", "kind": "url", @@ -1437,7 +1437,7 @@ "$id": "134", "Name": "jsonArrayAndFileArray", "ResourceName": "HttpParts", - "Description": "Test content-type: multipart/form-data for mixed scenarios", + "Doc": "Test content-type: multipart/form-data for mixed scenarios", "Accessibility": "public", "Parameters": [ { @@ -1519,7 +1519,7 @@ "$id": "141", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "142", "kind": "url", @@ -1557,7 +1557,7 @@ "$id": "146", "Name": "imageJpegContentType", "ResourceName": "ContentType", - "Description": "Test content-type: multipart/form-data", + "Doc": "Test content-type: multipart/form-data", "Accessibility": "public", "Parameters": [ { @@ -1633,7 +1633,7 @@ "$id": "152", "Name": "requiredContentType", "ResourceName": "ContentType", - "Description": "Test content-type: multipart/form-data", + "Doc": "Test content-type: multipart/form-data", "Accessibility": "public", "Parameters": [ { @@ -1709,7 +1709,7 @@ "$id": "158", "Name": "optionalContentType", "ResourceName": "ContentType", - "Description": "Test content-type: multipart/form-data for optional content type", + "Doc": "Test content-type: multipart/form-data for optional content type", "Accessibility": "public", "Parameters": [ { @@ -1791,7 +1791,7 @@ "$id": "165", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "166", "kind": "url", @@ -1829,7 +1829,7 @@ "$id": "170", "Name": "float", "ResourceName": "NonString", - "Description": "Test content-type: multipart/form-data for non string", + "Doc": "Test content-type: multipart/form-data for non string", "Accessibility": "public", "Parameters": [ { @@ -1911,7 +1911,7 @@ "$id": "177", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "178", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v1/tspCodeModel.json index 74f6ea412a..d850374c8e 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v1/tspCodeModel.json @@ -33,11 +33,11 @@ "enumType": { "$ref": "2" }, - "description": "Version 1", + "doc": "Version 1", "decorators": [] } ], - "description": "Service versions.", + "doc": "Service versions.", "isFixed": true, "isFlags": false, "usage": "ApiVersionEnum", @@ -49,13 +49,13 @@ { "$id": "6", "Name": "ResiliencyServiceDrivenClient", - "Description": "Test that we can grow up a service spec and service deployment into a multi-versioned service with full client support.", + "Doc": "Test that we can grow up a service spec and service deployment into a multi-versioned service with full client support.", "Operations": [ { "$id": "7", "Name": "fromNone", "ResourceName": "AddOptionalParam", - "Description": "Test that currently accepts no parameters, will be updated in next spec to accept a new optional parameter as well", + "Doc": "Test that currently accepts no parameters, will be updated in next spec to accept a new optional parameter as well", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -83,14 +83,14 @@ "$id": "9", "Name": "fromOneRequired", "ResourceName": "AddOptionalParam", - "Description": "Test that currently accepts one required parameter, will be updated in next spec to accept a new optional parameter as well", + "Doc": "Test that currently accepts one required parameter, will be updated in next spec to accept a new optional parameter as well", "Accessibility": "public", "Parameters": [ { "$id": "10", "Name": "parameter", "NameInRequest": "parameter", - "Description": "I am a required parameter", + "Doc": "I am a required parameter", "Type": { "$id": "11", "kind": "string", @@ -134,14 +134,14 @@ "$id": "13", "Name": "fromOneOptional", "ResourceName": "AddOptionalParam", - "Description": "Test that currently accepts one optional parameter, will be updated in next spec to accept a new optional parameter as well", + "Doc": "Test that currently accepts one optional parameter, will be updated in next spec to accept a new optional parameter as well", "Accessibility": "public", "Parameters": [ { "$id": "14", "Name": "parameter", "NameInRequest": "parameter", - "Description": "I am an optional parameter", + "Doc": "I am an optional parameter", "Type": { "$id": "15", "kind": "string", @@ -190,7 +190,7 @@ "$id": "18", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "19", "kind": "url", @@ -211,7 +211,7 @@ "$id": "20", "Name": "serviceDeploymentVersion", "NameInRequest": "serviceDeploymentVersion", - "Description": "Pass in either 'v1' or 'v2'. This represents a version of the service deployment in history. 'v1' is for the deployment when the service had only one api version. 'v2' is for the deployment when the service had api-versions 'v1' and 'v2'.", + "Doc": "Pass in either 'v1' or 'v2'. This represents a version of the service deployment in history. 'v1' is for the deployment when the service had only one api version. 'v2' is for the deployment when the service had api-versions 'v1' and 'v2'.", "Type": { "$id": "21", "kind": "string", @@ -233,7 +233,7 @@ "$id": "22", "Name": "apiVersion", "NameInRequest": "apiVersion", - "Description": "Pass in 'v1'. This represents the API version of the service. Will grow up in the next deployment to be both 'v1' and 'v2'", + "Doc": "Pass in 'v1'. This represents the API version of the service. Will grow up in the next deployment to be both 'v1' and 'v2'", "Type": { "$id": "23", "kind": "string", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v2/tspCodeModel.json index e1f8299af3..6e9845b930 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/resiliency/srv-driven/v2/tspCodeModel.json @@ -34,7 +34,7 @@ "enumType": { "$ref": "2" }, - "description": "Version 1", + "doc": "Version 1", "decorators": [] }, { @@ -52,11 +52,11 @@ "enumType": { "$ref": "2" }, - "description": "Version 2", + "doc": "Version 2", "decorators": [] } ], - "description": "Service versions", + "doc": "Service versions", "isFixed": true, "isFlags": false, "usage": "ApiVersionEnum", @@ -68,13 +68,13 @@ { "$id": "8", "Name": "ResiliencyServiceDrivenClient", - "Description": "Test that we can grow up a service spec and service deployment into a multi-versioned service with full client support.\n\nThere are three concepts that should be clarified:\n1. Client spec version: refers to the spec that the client is generated from. 'v1' is a client generated from old.tsp and 'v2' is a client generated from main.tsp.\n2. Service deployment version: refers to a deployment version of the service. 'v1' represents the initial deployment of the service with a single api version. 'v2' represents the new deployment of a service with multiple api versions\n3. Api version: The initial deployment of the service only supports api version 'v1'. The new deployment of the service supports api versions 'v1' and 'v2'.\n\nWe test the following configurations from this service spec:\n- A client generated from the second service spec can call the second deployment of a service with api version v1\n- A client generated from the second service spec can call the second deployment of a service with api version v2", + "Doc": "Test that we can grow up a service spec and service deployment into a multi-versioned service with full client support.\n\nThere are three concepts that should be clarified:\n1. Client spec version: refers to the spec that the client is generated from. 'v1' is a client generated from old.tsp and 'v2' is a client generated from main.tsp.\n2. Service deployment version: refers to a deployment version of the service. 'v1' represents the initial deployment of the service with a single api version. 'v2' represents the new deployment of a service with multiple api versions\n3. Api version: The initial deployment of the service only supports api version 'v1'. The new deployment of the service supports api versions 'v1' and 'v2'.\n\nWe test the following configurations from this service spec:\n- A client generated from the second service spec can call the second deployment of a service with api version v1\n- A client generated from the second service spec can call the second deployment of a service with api version v2", "Operations": [ { "$id": "9", "Name": "addOperation", "ResourceName": "ServiceDriven", - "Description": "Added operation", + "Doc": "Added operation", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -102,14 +102,14 @@ "$id": "11", "Name": "fromNone", "ResourceName": "AddOptionalParam", - "Description": "Test that grew up from accepting no parameters to an optional input parameter", + "Doc": "Test that grew up from accepting no parameters to an optional input parameter", "Accessibility": "public", "Parameters": [ { "$id": "12", "Name": "new-parameter", "NameInRequest": "new-parameter", - "Description": "I'm a new input optional parameter", + "Doc": "I'm a new input optional parameter", "Type": { "$id": "13", "kind": "string", @@ -153,14 +153,14 @@ "$id": "15", "Name": "fromOneRequired", "ResourceName": "AddOptionalParam", - "Description": "Operation that grew up from accepting one required parameter to accepting a required parameter and an optional parameter.", + "Doc": "Operation that grew up from accepting one required parameter to accepting a required parameter and an optional parameter.", "Accessibility": "public", "Parameters": [ { "$id": "16", "Name": "parameter", "NameInRequest": "parameter", - "Description": "I am a required parameter", + "Doc": "I am a required parameter", "Type": { "$id": "17", "kind": "string", @@ -182,7 +182,7 @@ "$id": "18", "Name": "new-parameter", "NameInRequest": "new-parameter", - "Description": "I'm a new input optional parameter", + "Doc": "I'm a new input optional parameter", "Type": { "$id": "19", "kind": "string", @@ -226,14 +226,14 @@ "$id": "21", "Name": "fromOneOptional", "ResourceName": "AddOptionalParam", - "Description": "Tests that we can grow up an operation from accepting one optional parameter to accepting two optional parameters.", + "Doc": "Tests that we can grow up an operation from accepting one optional parameter to accepting two optional parameters.", "Accessibility": "public", "Parameters": [ { "$id": "22", "Name": "parameter", "NameInRequest": "parameter", - "Description": "I am an optional parameter", + "Doc": "I am an optional parameter", "Type": { "$id": "23", "kind": "string", @@ -255,7 +255,7 @@ "$id": "24", "Name": "new-parameter", "NameInRequest": "new-parameter", - "Description": "I'm a new input optional parameter", + "Doc": "I'm a new input optional parameter", "Type": { "$id": "25", "kind": "string", @@ -304,7 +304,7 @@ "$id": "28", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "29", "kind": "url", @@ -325,7 +325,7 @@ "$id": "30", "Name": "serviceDeploymentVersion", "NameInRequest": "serviceDeploymentVersion", - "Description": "Pass in either 'v1' or 'v2'. This represents a version of the service deployment in history. 'v1' is for the deployment when the service had only one api version. 'v2' is for the deployment when the service had api-versions 'v1' and 'v2'.", + "Doc": "Pass in either 'v1' or 'v2'. This represents a version of the service deployment in history. 'v1' is for the deployment when the service had only one api version. 'v2' is for the deployment when the service had api-versions 'v1' and 'v2'.", "Type": { "$id": "31", "kind": "string", @@ -347,7 +347,7 @@ "$id": "32", "Name": "apiVersion", "NameInRequest": "apiVersion", - "Description": "Pass in either 'v1' or 'v2'. This represents the API version of a service.", + "Doc": "Pass in either 'v1' or 'v2'. This represents the API version of a service.", "Type": { "$id": "33", "kind": "string", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/routes/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/routes/tspCodeModel.json index fd9d5fbd52..9d12e8e692 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/routes/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/routes/tspCodeModel.json @@ -8,7 +8,7 @@ { "$id": "2", "Name": "RoutesClient", - "Description": "Define scenario in building the http route/uri", + "Doc": "Define scenario in building the http route/uri", "Operations": [ { "$id": "3", @@ -46,7 +46,7 @@ "$id": "6", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "7", "kind": "url", @@ -237,7 +237,7 @@ "$id": "24", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "25", "kind": "url", @@ -379,7 +379,7 @@ "$id": "38", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "39", "kind": "url", @@ -422,7 +422,7 @@ "$id": "44", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "45", "kind": "url", @@ -632,7 +632,7 @@ "$id": "65", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "66", "kind": "url", @@ -842,7 +842,7 @@ "$id": "86", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "87", "kind": "url", @@ -885,7 +885,7 @@ "$id": "92", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "93", "kind": "url", @@ -1095,7 +1095,7 @@ "$id": "113", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "114", "kind": "url", @@ -1305,7 +1305,7 @@ "$id": "134", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "135", "kind": "url", @@ -1348,7 +1348,7 @@ "$id": "140", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "141", "kind": "url", @@ -1558,7 +1558,7 @@ "$id": "161", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "162", "kind": "url", @@ -1768,7 +1768,7 @@ "$id": "182", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "183", "kind": "url", @@ -1811,7 +1811,7 @@ "$id": "188", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "189", "kind": "url", @@ -2021,7 +2021,7 @@ "$id": "209", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "210", "kind": "url", @@ -2231,7 +2231,7 @@ "$id": "230", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "231", "kind": "url", @@ -2422,7 +2422,7 @@ "$id": "248", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "249", "kind": "url", @@ -2465,7 +2465,7 @@ "$id": "254", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "255", "kind": "url", @@ -2675,7 +2675,7 @@ "$id": "275", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "276", "kind": "url", @@ -2885,7 +2885,7 @@ "$id": "296", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "297", "kind": "url", @@ -2928,7 +2928,7 @@ "$id": "302", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "303", "kind": "url", @@ -3138,7 +3138,7 @@ "$id": "323", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "324", "kind": "url", @@ -3348,7 +3348,7 @@ "$id": "344", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "345", "kind": "url", @@ -3419,7 +3419,7 @@ "$id": "352", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "353", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/serialization/encoded-name/json/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/serialization/encoded-name/json/tspCodeModel.json index c0c94e895d..ff49774478 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/serialization/encoded-name/json/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/serialization/encoded-name/json/tspCodeModel.json @@ -17,7 +17,7 @@ "kind": "property", "name": "defaultName", "serializedName": "wireName", - "description": "Pass in true", + "doc": "Pass in true", "type": { "$id": "4", "kind": "boolean", @@ -39,7 +39,7 @@ { "$id": "5", "Name": "JsonClient", - "Description": "Projection", + "Doc": "Projection", "Operations": [], "Protocol": { "$id": "6" @@ -49,7 +49,7 @@ "$id": "7", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "8", "kind": "url", @@ -93,7 +93,7 @@ "$id": "13", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "14", "kind": "constant", @@ -230,7 +230,7 @@ "$id": "24", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "25", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/endpoint/not-defined/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/endpoint/not-defined/tspCodeModel.json index 097d7cba3a..2ab00f8161 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/endpoint/not-defined/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/endpoint/not-defined/tspCodeModel.json @@ -8,7 +8,7 @@ { "$id": "2", "Name": "NotDefinedClient", - "Description": "Illustrates server doesn't define endpoint. Client should automatically add an endpoint to let user pass in.", + "Doc": "Illustrates server doesn't define endpoint. Client should automatically add an endpoint to let user pass in.", "Operations": [ { "$id": "3", @@ -46,7 +46,7 @@ "$id": "6", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "7", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/multiple/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/multiple/tspCodeModel.json index cd1fef80dc..198f6ce797 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/multiple/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/multiple/tspCodeModel.json @@ -33,11 +33,11 @@ "enumType": { "$ref": "2" }, - "description": "Version 1.0", + "doc": "Version 1.0", "decorators": [] } ], - "description": "Service versions", + "doc": "Service versions", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -135,7 +135,7 @@ "$id": "14", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Pass in http://localhost:3000 for endpoint.", + "Doc": "Pass in http://localhost:3000 for endpoint.", "Type": { "$id": "15", "kind": "url", @@ -156,7 +156,7 @@ "$id": "16", "Name": "apiVersion", "NameInRequest": "apiVersion", - "Description": "Pass in v1.0 for API version.", + "Doc": "Pass in v1.0 for API version.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/single/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/single/tspCodeModel.json index 636acaa93e..1233ed4a75 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/single/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/path/single/tspCodeModel.json @@ -8,7 +8,7 @@ { "$id": "2", "Name": "SingleClient", - "Description": "Illustrates server with a single path parameter @server", + "Doc": "Illustrates server with a single path parameter @server", "Operations": [ { "$id": "3", @@ -46,7 +46,7 @@ "$id": "6", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "7", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/not-versioned/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/not-versioned/tspCodeModel.json index d0ce8e8b4a..c337d4f2e0 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/not-versioned/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/not-versioned/tspCodeModel.json @@ -8,7 +8,7 @@ { "$id": "2", "Name": "NotVersionedClient", - "Description": "Illustrates not-versioned server.", + "Doc": "Illustrates not-versioned server.", "Operations": [ { "$id": "3", @@ -144,7 +144,7 @@ "$id": "14", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "15", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/versioned/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/versioned/tspCodeModel.json index 5cdd01c21b..a9eb23eb2f 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/versioned/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/server/versions/versioned/tspCodeModel.json @@ -34,7 +34,7 @@ "enumType": { "$ref": "2" }, - "description": "The version 2022-12-01-preview.", + "doc": "The version 2022-12-01-preview.", "decorators": [] }, { @@ -52,11 +52,11 @@ "enumType": { "$ref": "2" }, - "description": "The version 2022-12-01-preview.", + "doc": "The version 2022-12-01-preview.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "ApiVersionEnum", @@ -68,7 +68,7 @@ { "$id": "8", "Name": "VersionedClient", - "Description": "Illustrates versioned server.", + "Doc": "Illustrates versioned server.", "Operations": [ { "$id": "9", @@ -283,7 +283,7 @@ "$id": "30", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "31", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/conditional-request/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/conditional-request/tspCodeModel.json index 1ee0e40c9e..4a91ded18f 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/conditional-request/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/conditional-request/tspCodeModel.json @@ -8,20 +8,20 @@ { "$id": "2", "Name": "ConditionalRequestClient", - "Description": "Illustrates conditional request headers", + "Doc": "Illustrates conditional request headers", "Operations": [ { "$id": "3", "Name": "postIfMatch", "ResourceName": "ConditionalRequest", - "Description": "Check when only If-Match in header is defined.", + "Doc": "Check when only If-Match in header is defined.", "Accessibility": "public", "Parameters": [ { "$id": "4", "Name": "ifMatch", "NameInRequest": "If-Match", - "Description": "The request should only proceed if an entity matches this string.", + "Doc": "The request should only proceed if an entity matches this string.", "Type": { "$id": "5", "kind": "string", @@ -65,14 +65,14 @@ "$id": "7", "Name": "postIfNoneMatch", "ResourceName": "ConditionalRequest", - "Description": "Check when only If-None-Match in header is defined.", + "Doc": "Check when only If-None-Match in header is defined.", "Accessibility": "public", "Parameters": [ { "$id": "8", "Name": "ifNoneMatch", "NameInRequest": "If-None-Match", - "Description": "The request should only proceed if no entity matches this string.", + "Doc": "The request should only proceed if no entity matches this string.", "Type": { "$id": "9", "kind": "string", @@ -116,14 +116,14 @@ "$id": "11", "Name": "headIfModifiedSince", "ResourceName": "ConditionalRequest", - "Description": "Check when only If-Modified-Since in header is defined.", + "Doc": "Check when only If-Modified-Since in header is defined.", "Accessibility": "public", "Parameters": [ { "$id": "12", "Name": "ifModifiedSince", "NameInRequest": "If-Modified-Since", - "Description": "A timestamp indicating the last modified time of the resource known to the\nclient. The operation will be performed only if the resource on the service has\nbeen modified since the specified time.", + "Doc": "A timestamp indicating the last modified time of the resource known to the\nclient. The operation will be performed only if the resource on the service has\nbeen modified since the specified time.", "Type": { "$id": "13", "kind": "utcDateTime", @@ -175,14 +175,14 @@ "$id": "16", "Name": "postIfUnmodifiedSince", "ResourceName": "ConditionalRequest", - "Description": "Check when only If-Unmodified-Since in header is defined.", + "Doc": "Check when only If-Unmodified-Since in header is defined.", "Accessibility": "public", "Parameters": [ { "$id": "17", "Name": "ifUnmodifiedSince", "NameInRequest": "If-Unmodified-Since", - "Description": "A timestamp indicating the last modified time of the resource known to the\nclient. The operation will be performed only if the resource on the service has\nnot been modified since the specified time.", + "Doc": "A timestamp indicating the last modified time of the resource known to the\nclient. The operation will be performed only if the resource on the service has\nnot been modified since the specified time.", "Type": { "$id": "18", "kind": "utcDateTime", @@ -239,7 +239,7 @@ "$id": "22", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "23", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/repeatability/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/repeatability/tspCodeModel.json index 313813feca..0827f4750f 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/repeatability/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-headers/repeatability/tspCodeModel.json @@ -62,13 +62,13 @@ { "$id": "8", "Name": "RepeatabilityClient", - "Description": "Illustrates OASIS repeatability headers", + "Doc": "Illustrates OASIS repeatability headers", "Operations": [ { "$id": "9", "Name": "immediateSuccess", "ResourceName": "Repeatability", - "Description": "Check we recognize Repeatability-Request-ID and Repeatability-First-Sent.", + "Doc": "Check we recognize Repeatability-Request-ID and Repeatability-First-Sent.", "Accessibility": "public", "Parameters": [ { @@ -134,7 +134,7 @@ "$id": "16", "Name": "repeatabilityResult", "NameInResponse": "Repeatability-Result", - "Description": "Indicates whether the repeatable request was accepted or rejected.", + "Doc": "Indicates whether the repeatable request was accepted or rejected.", "Type": { "$ref": "2" } @@ -162,7 +162,7 @@ "$id": "18", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "19", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-words/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-words/tspCodeModel.json index db71e6b428..ae4ec34c19 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-words/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/special-words/tspCodeModel.json @@ -995,7 +995,7 @@ { "$id": "104", "Name": "SpecialWordsClient", - "Description": "Scenarios to verify that reserved words can be used in service and generators will handle it appropriately.\n\nCurrent list of special words\n```txt\nand\nas\nassert\nasync\nawait\nbreak\nclass\nconstructor\ncontinue\ndef\ndel\nelif\nelse\nexcept\nexec\nfinally\nfor\nfrom\nglobal\nif\nimport\nin\nis\nlambda\nnot\nor\npass\nraise\nreturn\ntry\nwhile\nwith\nyield\n```", + "Doc": "Scenarios to verify that reserved words can be used in service and generators will handle it appropriately.\n\nCurrent list of special words\n```txt\nand\nas\nassert\nasync\nawait\nbreak\nclass\nconstructor\ncontinue\ndef\ndel\nelif\nelse\nexcept\nexec\nfinally\nfor\nfrom\nglobal\nif\nimport\nin\nis\nlambda\nnot\nor\npass\nraise\nreturn\ntry\nwhile\nwith\nyield\n```", "Operations": [], "Protocol": { "$id": "105" @@ -1005,7 +1005,7 @@ "$id": "106", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "107", "kind": "url", @@ -1038,7 +1038,7 @@ { "$id": "110", "Name": "ModelsOps", - "Description": "Verify model names", + "Doc": "Verify model names", "Operations": [ { "$id": "111", @@ -1050,7 +1050,7 @@ "$id": "112", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "113", "kind": "constant", @@ -1126,7 +1126,7 @@ "$id": "118", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "119", "kind": "constant", @@ -1202,7 +1202,7 @@ "$id": "124", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "125", "kind": "constant", @@ -1278,7 +1278,7 @@ "$id": "130", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "131", "kind": "constant", @@ -1354,7 +1354,7 @@ "$id": "136", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "137", "kind": "constant", @@ -1430,7 +1430,7 @@ "$id": "142", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "143", "kind": "constant", @@ -1506,7 +1506,7 @@ "$id": "148", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "149", "kind": "constant", @@ -1582,7 +1582,7 @@ "$id": "154", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "155", "kind": "constant", @@ -1658,7 +1658,7 @@ "$id": "160", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "161", "kind": "constant", @@ -1734,7 +1734,7 @@ "$id": "166", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "167", "kind": "constant", @@ -1810,7 +1810,7 @@ "$id": "172", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "173", "kind": "constant", @@ -1886,7 +1886,7 @@ "$id": "178", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "179", "kind": "constant", @@ -1962,7 +1962,7 @@ "$id": "184", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "185", "kind": "constant", @@ -2038,7 +2038,7 @@ "$id": "190", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "191", "kind": "constant", @@ -2114,7 +2114,7 @@ "$id": "196", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "197", "kind": "constant", @@ -2190,7 +2190,7 @@ "$id": "202", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "203", "kind": "constant", @@ -2266,7 +2266,7 @@ "$id": "208", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "209", "kind": "constant", @@ -2342,7 +2342,7 @@ "$id": "214", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "215", "kind": "constant", @@ -2418,7 +2418,7 @@ "$id": "220", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "221", "kind": "constant", @@ -2494,7 +2494,7 @@ "$id": "226", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "227", "kind": "constant", @@ -2570,7 +2570,7 @@ "$id": "232", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "233", "kind": "constant", @@ -2646,7 +2646,7 @@ "$id": "238", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "239", "kind": "constant", @@ -2722,7 +2722,7 @@ "$id": "244", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "245", "kind": "constant", @@ -2798,7 +2798,7 @@ "$id": "250", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "251", "kind": "constant", @@ -2874,7 +2874,7 @@ "$id": "256", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "257", "kind": "constant", @@ -2950,7 +2950,7 @@ "$id": "262", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "263", "kind": "constant", @@ -3026,7 +3026,7 @@ "$id": "268", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "269", "kind": "constant", @@ -3102,7 +3102,7 @@ "$id": "274", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "275", "kind": "constant", @@ -3178,7 +3178,7 @@ "$id": "280", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "281", "kind": "constant", @@ -3254,7 +3254,7 @@ "$id": "286", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "287", "kind": "constant", @@ -3330,7 +3330,7 @@ "$id": "292", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "293", "kind": "constant", @@ -3406,7 +3406,7 @@ "$id": "298", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "299", "kind": "constant", @@ -3482,7 +3482,7 @@ "$id": "304", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "305", "kind": "constant", @@ -3558,7 +3558,7 @@ "$id": "310", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "311", "kind": "url", @@ -3591,7 +3591,7 @@ { "$id": "314", "Name": "ModelProperties", - "Description": "Verify model names", + "Doc": "Verify model names", "Operations": [ { "$id": "315", @@ -3603,7 +3603,7 @@ "$id": "316", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "317", "kind": "constant", @@ -3679,7 +3679,7 @@ "$id": "322", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "323", "kind": "url", @@ -3712,7 +3712,7 @@ { "$id": "326", "Name": "Operations", - "Description": "Test reserved words as operation name.", + "Doc": "Test reserved words as operation name.", "Operations": [ { "$id": "327", @@ -4615,7 +4615,7 @@ "$id": "394", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "395", "kind": "url", @@ -4648,7 +4648,7 @@ { "$id": "398", "Name": "Parameters", - "Description": "Verify reserved words as parameter name.", + "Doc": "Verify reserved words as parameter name.", "Operations": [ { "$id": "399", @@ -6326,7 +6326,7 @@ "$id": "536", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "537", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/array/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/array/tspCodeModel.json index 3fecf5468b..d6e1378995 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/array/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/array/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "InnerModel", "crossLanguageDefinitionId": "Type.Array.InnerModel", "usage": "Input,Output,Json", - "description": "Array inner model", + "doc": "Array inner model", "decorators": [], "properties": [ { @@ -18,7 +18,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Required string property", + "doc": "Required string property", "type": { "$id": "4", "kind": "string", @@ -62,7 +62,7 @@ { "$id": "7", "Name": "ArrayClient", - "Description": "Illustrates various types of arrays.", + "Doc": "Illustrates various types of arrays.", "Operations": [], "Protocol": { "$id": "8" @@ -72,7 +72,7 @@ "$id": "9", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "10", "kind": "url", @@ -105,7 +105,7 @@ { "$id": "13", "Name": "Int32Value", - "Description": "Array of int32 values", + "Doc": "Array of int32 values", "Operations": [ { "$id": "14", @@ -189,7 +189,7 @@ "$id": "22", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "23", "kind": "constant", @@ -276,7 +276,7 @@ "$id": "30", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "31", "kind": "url", @@ -309,7 +309,7 @@ { "$id": "34", "Name": "Int64Value", - "Description": "Array of int64 values", + "Doc": "Array of int64 values", "Operations": [ { "$id": "35", @@ -393,7 +393,7 @@ "$id": "43", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "44", "kind": "constant", @@ -480,7 +480,7 @@ "$id": "51", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "52", "kind": "url", @@ -513,7 +513,7 @@ { "$id": "55", "Name": "BooleanValue", - "Description": "Array of boolean values", + "Doc": "Array of boolean values", "Operations": [ { "$id": "56", @@ -597,7 +597,7 @@ "$id": "64", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "65", "kind": "constant", @@ -684,7 +684,7 @@ "$id": "72", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "73", "kind": "url", @@ -717,7 +717,7 @@ { "$id": "76", "Name": "StringValue", - "Description": "Array of string values", + "Doc": "Array of string values", "Operations": [ { "$id": "77", @@ -801,7 +801,7 @@ "$id": "85", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "86", "kind": "constant", @@ -888,7 +888,7 @@ "$id": "93", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "94", "kind": "url", @@ -921,7 +921,7 @@ { "$id": "97", "Name": "Float32Value", - "Description": "Array of float values", + "Doc": "Array of float values", "Operations": [ { "$id": "98", @@ -1005,7 +1005,7 @@ "$id": "106", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "107", "kind": "constant", @@ -1092,7 +1092,7 @@ "$id": "114", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "115", "kind": "url", @@ -1125,7 +1125,7 @@ { "$id": "118", "Name": "DatetimeValue", - "Description": "Array of datetime values", + "Doc": "Array of datetime values", "Operations": [ { "$id": "119", @@ -1217,7 +1217,7 @@ "$id": "128", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "129", "kind": "constant", @@ -1312,7 +1312,7 @@ "$id": "137", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "138", "kind": "url", @@ -1345,7 +1345,7 @@ { "$id": "141", "Name": "DurationValue", - "Description": "Array of duration values", + "Doc": "Array of duration values", "Operations": [ { "$id": "142", @@ -1437,7 +1437,7 @@ "$id": "151", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "152", "kind": "constant", @@ -1532,7 +1532,7 @@ "$id": "160", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "161", "kind": "url", @@ -1565,7 +1565,7 @@ { "$id": "164", "Name": "UnknownValue", - "Description": "Array of unknown values", + "Doc": "Array of unknown values", "Operations": [ { "$id": "165", @@ -1649,7 +1649,7 @@ "$id": "173", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "174", "kind": "constant", @@ -1736,7 +1736,7 @@ "$id": "181", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "182", "kind": "url", @@ -1769,7 +1769,7 @@ { "$id": "185", "Name": "ModelValue", - "Description": "Array of model values", + "Doc": "Array of model values", "Operations": [ { "$id": "186", @@ -1849,7 +1849,7 @@ "$id": "193", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "194", "kind": "constant", @@ -1932,7 +1932,7 @@ "$id": "200", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "201", "kind": "url", @@ -1965,7 +1965,7 @@ { "$id": "204", "Name": "NullableFloatValue", - "Description": "Array of nullable float values", + "Doc": "Array of nullable float values", "Operations": [ { "$id": "205", @@ -2053,7 +2053,7 @@ "$id": "214", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "215", "kind": "constant", @@ -2136,7 +2136,7 @@ "$id": "221", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "222", "kind": "url", @@ -2169,7 +2169,7 @@ { "$id": "225", "Name": "NullableInt32Value", - "Description": "Array of nullable int32 values", + "Doc": "Array of nullable int32 values", "Operations": [ { "$id": "226", @@ -2257,7 +2257,7 @@ "$id": "235", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "236", "kind": "constant", @@ -2340,7 +2340,7 @@ "$id": "242", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "243", "kind": "url", @@ -2373,7 +2373,7 @@ { "$id": "246", "Name": "NullableBooleanValue", - "Description": "Array of nullable boolean values", + "Doc": "Array of nullable boolean values", "Operations": [ { "$id": "247", @@ -2461,7 +2461,7 @@ "$id": "256", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "257", "kind": "constant", @@ -2544,7 +2544,7 @@ "$id": "263", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "264", "kind": "url", @@ -2577,7 +2577,7 @@ { "$id": "267", "Name": "NullableStringValue", - "Description": "Array of nullable string values", + "Doc": "Array of nullable string values", "Operations": [ { "$id": "268", @@ -2665,7 +2665,7 @@ "$id": "277", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "278", "kind": "constant", @@ -2748,7 +2748,7 @@ "$id": "284", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "285", "kind": "url", @@ -2781,7 +2781,7 @@ { "$id": "288", "Name": "NullableModelValue", - "Description": "Array of nullable model values", + "Doc": "Array of nullable model values", "Operations": [ { "$id": "289", @@ -2865,7 +2865,7 @@ "$id": "297", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "298", "kind": "constant", @@ -2948,7 +2948,7 @@ "$id": "304", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "305", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/dictionary/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/dictionary/tspCodeModel.json index 870aab372b..66058bb59c 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/dictionary/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/dictionary/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "InnerModel", "crossLanguageDefinitionId": "Type.Dictionary.InnerModel", "usage": "Input,Output,Json", - "description": "Dictionary inner model", + "doc": "Dictionary inner model", "decorators": [], "properties": [ { @@ -18,7 +18,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Required string property", + "doc": "Required string property", "type": { "$id": "4", "kind": "string", @@ -67,7 +67,7 @@ { "$id": "8", "Name": "DictionaryClient", - "Description": "Illustrates various of dictionaries.", + "Doc": "Illustrates various of dictionaries.", "Operations": [], "Protocol": { "$id": "9" @@ -77,7 +77,7 @@ "$id": "10", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "11", "kind": "url", @@ -110,7 +110,7 @@ { "$id": "14", "Name": "Int32Value", - "Description": "Dictionary of int32 values", + "Doc": "Dictionary of int32 values", "Operations": [ { "$id": "15", @@ -199,7 +199,7 @@ "$id": "24", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "25", "kind": "constant", @@ -291,7 +291,7 @@ "$id": "33", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "34", "kind": "url", @@ -324,7 +324,7 @@ { "$id": "37", "Name": "Int64Value", - "Description": "Dictionary of int64 values", + "Doc": "Dictionary of int64 values", "Operations": [ { "$id": "38", @@ -413,7 +413,7 @@ "$id": "47", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "48", "kind": "constant", @@ -505,7 +505,7 @@ "$id": "56", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "57", "kind": "url", @@ -538,7 +538,7 @@ { "$id": "60", "Name": "BooleanValue", - "Description": "Dictionary of boolean values", + "Doc": "Dictionary of boolean values", "Operations": [ { "$id": "61", @@ -627,7 +627,7 @@ "$id": "70", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "71", "kind": "constant", @@ -719,7 +719,7 @@ "$id": "79", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "80", "kind": "url", @@ -752,7 +752,7 @@ { "$id": "83", "Name": "StringValue", - "Description": "Dictionary of string values", + "Doc": "Dictionary of string values", "Operations": [ { "$id": "84", @@ -841,7 +841,7 @@ "$id": "93", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "94", "kind": "constant", @@ -933,7 +933,7 @@ "$id": "102", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "103", "kind": "url", @@ -966,7 +966,7 @@ { "$id": "106", "Name": "Float32Value", - "Description": "Dictionary of float values", + "Doc": "Dictionary of float values", "Operations": [ { "$id": "107", @@ -1055,7 +1055,7 @@ "$id": "116", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "117", "kind": "constant", @@ -1147,7 +1147,7 @@ "$id": "125", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "126", "kind": "url", @@ -1180,7 +1180,7 @@ { "$id": "129", "Name": "DatetimeValue", - "Description": "Dictionary of datetime values", + "Doc": "Dictionary of datetime values", "Operations": [ { "$id": "130", @@ -1277,7 +1277,7 @@ "$id": "140", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "141", "kind": "constant", @@ -1377,7 +1377,7 @@ "$id": "150", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "151", "kind": "url", @@ -1410,7 +1410,7 @@ { "$id": "154", "Name": "DurationValue", - "Description": "Dictionary of duration values", + "Doc": "Dictionary of duration values", "Operations": [ { "$id": "155", @@ -1507,7 +1507,7 @@ "$id": "165", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "166", "kind": "constant", @@ -1607,7 +1607,7 @@ "$id": "175", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "176", "kind": "url", @@ -1640,7 +1640,7 @@ { "$id": "179", "Name": "UnknownValue", - "Description": "Dictionary of unknown values", + "Doc": "Dictionary of unknown values", "Operations": [ { "$id": "180", @@ -1729,7 +1729,7 @@ "$id": "189", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "190", "kind": "constant", @@ -1821,7 +1821,7 @@ "$id": "198", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "199", "kind": "url", @@ -1854,7 +1854,7 @@ { "$id": "202", "Name": "ModelValue", - "Description": "Dictionary of model values", + "Doc": "Dictionary of model values", "Operations": [ { "$id": "203", @@ -1939,7 +1939,7 @@ "$id": "211", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "212", "kind": "constant", @@ -2027,7 +2027,7 @@ "$id": "219", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "220", "kind": "url", @@ -2060,7 +2060,7 @@ { "$id": "223", "Name": "RecursiveModelValue", - "Description": "Dictionary of model values", + "Doc": "Dictionary of model values", "Operations": [ { "$id": "224", @@ -2145,7 +2145,7 @@ "$id": "232", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "233", "kind": "constant", @@ -2233,7 +2233,7 @@ "$id": "240", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "241", "kind": "url", @@ -2266,7 +2266,7 @@ { "$id": "244", "Name": "NullableFloatValue", - "Description": "Dictionary of nullable float values", + "Doc": "Dictionary of nullable float values", "Operations": [ { "$id": "245", @@ -2359,7 +2359,7 @@ "$id": "255", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "256", "kind": "constant", @@ -2447,7 +2447,7 @@ "$id": "263", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "264", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/extensible/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/extensible/tspCodeModel.json index e1a58db7dd..8cc09068b1 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/extensible/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/extensible/tspCodeModel.json @@ -31,7 +31,7 @@ "enumType": { "$ref": "2" }, - "description": "Monday.", + "doc": "Monday.", "decorators": [] }, { @@ -49,7 +49,7 @@ "enumType": { "$ref": "2" }, - "description": "Tuesday.", + "doc": "Tuesday.", "decorators": [] }, { @@ -67,7 +67,7 @@ "enumType": { "$ref": "2" }, - "description": "Wednesday.", + "doc": "Wednesday.", "decorators": [] }, { @@ -85,7 +85,7 @@ "enumType": { "$ref": "2" }, - "description": "Thursday.", + "doc": "Thursday.", "decorators": [] }, { @@ -103,7 +103,7 @@ "enumType": { "$ref": "2" }, - "description": "Friday.", + "doc": "Friday.", "decorators": [] }, { @@ -121,7 +121,7 @@ "enumType": { "$ref": "2" }, - "description": "Saturday.", + "doc": "Saturday.", "decorators": [] }, { @@ -139,11 +139,11 @@ "enumType": { "$ref": "2" }, - "description": "Sunday.", + "doc": "Sunday.", "decorators": [] } ], - "description": "Days of the week", + "doc": "Days of the week", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -164,7 +164,7 @@ "$id": "20", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "21", "kind": "url", @@ -330,7 +330,7 @@ "$id": "36", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "37", "kind": "constant", @@ -406,7 +406,7 @@ "$id": "42", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "43", "kind": "constant", @@ -482,7 +482,7 @@ "$id": "48", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "49", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/fixed/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/fixed/tspCodeModel.json index 619ff5a0c5..3487706435 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/fixed/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/enum/fixed/tspCodeModel.json @@ -31,7 +31,7 @@ "enumType": { "$ref": "2" }, - "description": "Monday.", + "doc": "Monday.", "decorators": [] }, { @@ -49,7 +49,7 @@ "enumType": { "$ref": "2" }, - "description": "Tuesday.", + "doc": "Tuesday.", "decorators": [] }, { @@ -67,7 +67,7 @@ "enumType": { "$ref": "2" }, - "description": "Wednesday.", + "doc": "Wednesday.", "decorators": [] }, { @@ -85,7 +85,7 @@ "enumType": { "$ref": "2" }, - "description": "Thursday.", + "doc": "Thursday.", "decorators": [] }, { @@ -103,7 +103,7 @@ "enumType": { "$ref": "2" }, - "description": "Friday.", + "doc": "Friday.", "decorators": [] }, { @@ -121,7 +121,7 @@ "enumType": { "$ref": "2" }, - "description": "Saturday.", + "doc": "Saturday.", "decorators": [] }, { @@ -139,11 +139,11 @@ "enumType": { "$ref": "2" }, - "description": "Sunday.", + "doc": "Sunday.", "decorators": [] } ], - "description": "Days of the week", + "doc": "Days of the week", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -164,7 +164,7 @@ "$id": "20", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "21", "kind": "url", @@ -202,7 +202,7 @@ "$id": "25", "Name": "getKnownValue", "ResourceName": "String", - "Description": "getKnownValue", + "Doc": "getKnownValue", "Accessibility": "public", "Parameters": [ { @@ -264,14 +264,14 @@ "$id": "30", "Name": "putKnownValue", "ResourceName": "String", - "Description": "putKnownValue", + "Doc": "putKnownValue", "Accessibility": "public", "Parameters": [ { "$id": "31", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "32", "kind": "constant", @@ -299,7 +299,7 @@ "$id": "34", "Name": "body", "NameInRequest": "body", - "Description": "_", + "Doc": "_", "Type": { "$ref": "2" }, @@ -342,14 +342,14 @@ "$id": "36", "Name": "putUnknownValue", "ResourceName": "String", - "Description": "putUnknownValue", + "Doc": "putUnknownValue", "Accessibility": "public", "Parameters": [ { "$id": "37", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "38", "kind": "constant", @@ -377,7 +377,7 @@ "$id": "40", "Name": "body", "NameInRequest": "body", - "Description": "_", + "Doc": "_", "Type": { "$ref": "2" }, @@ -426,7 +426,7 @@ "$id": "43", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "44", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/empty/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/empty/tspCodeModel.json index e645bf4027..293823d38f 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/empty/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/empty/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "EmptyInput", "crossLanguageDefinitionId": "Type.Model.Empty.EmptyInput", "usage": "Input,Json", - "description": "Empty model used in operation parameters", + "doc": "Empty model used in operation parameters", "decorators": [], "properties": [] }, @@ -20,7 +20,7 @@ "name": "EmptyOutput", "crossLanguageDefinitionId": "Type.Model.Empty.EmptyOutput", "usage": "Output,Json", - "description": "Empty model used in operation return type", + "doc": "Empty model used in operation return type", "decorators": [], "properties": [] }, @@ -30,7 +30,7 @@ "name": "EmptyInputOutput", "crossLanguageDefinitionId": "Type.Model.Empty.EmptyInputOutput", "usage": "Input,Output,Json", - "description": "Empty model used in both parameter and return type", + "doc": "Empty model used in both parameter and return type", "decorators": [], "properties": [] } @@ -39,7 +39,7 @@ { "$id": "5", "Name": "EmptyClient", - "Description": "Illustrates usage of empty model used in operation's parameters and responses.", + "Doc": "Illustrates usage of empty model used in operation's parameters and responses.", "Operations": [ { "$id": "6", @@ -51,7 +51,7 @@ "$id": "7", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "8", "kind": "constant", @@ -188,7 +188,7 @@ "$id": "18", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "19", "kind": "constant", @@ -296,7 +296,7 @@ "$id": "27", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "28", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/enum-discriminator/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/enum-discriminator/tspCodeModel.json index 3c94a1dd97..ffb18ff353 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/enum-discriminator/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/enum-discriminator/tspCodeModel.json @@ -31,11 +31,11 @@ "enumType": { "$ref": "2" }, - "description": "Species golden", + "doc": "Species golden", "decorators": [] } ], - "description": "extensible enum type for discriminator", + "doc": "extensible enum type for discriminator", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -69,11 +69,11 @@ "enumType": { "$ref": "6" }, - "description": "Species cobra", + "doc": "Species cobra", "decorators": [] } ], - "description": "fixed enum type for discriminator", + "doc": "fixed enum type for discriminator", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -87,14 +87,14 @@ "name": "Dog", "crossLanguageDefinitionId": "Type.Model.Inheritance.EnumDiscriminator.Dog", "usage": "Input,Output,Json", - "description": "Test extensible enum type for discriminator", + "doc": "Test extensible enum type for discriminator", "decorators": [], "discriminatorProperty": { "$id": "11", "kind": "property", "name": "kind", "serializedName": "kind", - "description": "discriminator property", + "doc": "discriminator property", "type": { "$ref": "2" }, @@ -114,7 +114,7 @@ "kind": "property", "name": "weight", "serializedName": "weight", - "description": "Weight of the dog", + "doc": "Weight of the dog", "type": { "$id": "13", "kind": "int32", @@ -138,7 +138,7 @@ "name": "Golden", "crossLanguageDefinitionId": "Type.Model.Inheritance.EnumDiscriminator.Golden", "usage": "Input,Output,Json", - "description": "Golden dog model", + "doc": "Golden dog model", "discriminatorValue": "golden", "decorators": [], "baseModel": { @@ -150,7 +150,7 @@ "kind": "property", "name": "kind", "serializedName": "kind", - "description": "discriminator property", + "doc": "discriminator property", "type": { "$id": "17", "kind": "constant", @@ -184,14 +184,14 @@ "name": "Snake", "crossLanguageDefinitionId": "Type.Model.Inheritance.EnumDiscriminator.Snake", "usage": "Input,Output,Json", - "description": "Test fixed enum type for discriminator", + "doc": "Test fixed enum type for discriminator", "decorators": [], "discriminatorProperty": { "$id": "20", "kind": "property", "name": "kind", "serializedName": "kind", - "description": "discriminator property", + "doc": "discriminator property", "type": { "$ref": "6" }, @@ -211,7 +211,7 @@ "kind": "property", "name": "length", "serializedName": "length", - "description": "Length of the snake", + "doc": "Length of the snake", "type": { "$id": "22", "kind": "int32", @@ -235,7 +235,7 @@ "name": "Cobra", "crossLanguageDefinitionId": "Type.Model.Inheritance.EnumDiscriminator.Cobra", "usage": "Input,Output,Json", - "description": "Cobra model", + "doc": "Cobra model", "discriminatorValue": "cobra", "decorators": [], "baseModel": { @@ -247,7 +247,7 @@ "kind": "property", "name": "kind", "serializedName": "kind", - "description": "discriminator property", + "doc": "discriminator property", "type": { "$id": "26", "kind": "constant", @@ -280,13 +280,13 @@ { "$id": "28", "Name": "EnumDiscriminatorClient", - "Description": "Illustrates inheritance with enum discriminator.", + "Doc": "Illustrates inheritance with enum discriminator.", "Operations": [ { "$id": "29", "Name": "getExtensibleModel", "ResourceName": "EnumDiscriminator", - "Description": "Receive model with extensible enum discriminator type.", + "Doc": "Receive model with extensible enum discriminator type.", "Accessibility": "public", "Parameters": [ { @@ -348,14 +348,14 @@ "$id": "34", "Name": "putExtensibleModel", "ResourceName": "EnumDiscriminator", - "Description": "Send model with extensible enum discriminator type.", + "Doc": "Send model with extensible enum discriminator type.", "Accessibility": "public", "Parameters": [ { "$id": "35", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "36", "kind": "constant", @@ -383,7 +383,7 @@ "$id": "38", "Name": "input", "NameInRequest": "input", - "Description": "Dog to create", + "Doc": "Dog to create", "Type": { "$ref": "10" }, @@ -426,7 +426,7 @@ "$id": "40", "Name": "getExtensibleModelMissingDiscriminator", "ResourceName": "EnumDiscriminator", - "Description": "Get a model omitting the discriminator.", + "Doc": "Get a model omitting the discriminator.", "Accessibility": "public", "Parameters": [ { @@ -488,7 +488,7 @@ "$id": "45", "Name": "getExtensibleModelWrongDiscriminator", "ResourceName": "EnumDiscriminator", - "Description": "Get a model containing discriminator value never defined.", + "Doc": "Get a model containing discriminator value never defined.", "Accessibility": "public", "Parameters": [ { @@ -550,7 +550,7 @@ "$id": "50", "Name": "getFixedModel", "ResourceName": "EnumDiscriminator", - "Description": "Receive model with fixed enum discriminator type.", + "Doc": "Receive model with fixed enum discriminator type.", "Accessibility": "public", "Parameters": [ { @@ -612,14 +612,14 @@ "$id": "55", "Name": "putFixedModel", "ResourceName": "EnumDiscriminator", - "Description": "Send model with fixed enum discriminator type.", + "Doc": "Send model with fixed enum discriminator type.", "Accessibility": "public", "Parameters": [ { "$id": "56", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "57", "kind": "constant", @@ -647,7 +647,7 @@ "$id": "59", "Name": "input", "NameInRequest": "input", - "Description": "Snake to create", + "Doc": "Snake to create", "Type": { "$ref": "19" }, @@ -690,7 +690,7 @@ "$id": "61", "Name": "getFixedModelMissingDiscriminator", "ResourceName": "EnumDiscriminator", - "Description": "Get a model omitting the discriminator.", + "Doc": "Get a model omitting the discriminator.", "Accessibility": "public", "Parameters": [ { @@ -752,7 +752,7 @@ "$id": "66", "Name": "getFixedModelWrongDiscriminator", "ResourceName": "EnumDiscriminator", - "Description": "Get a model containing discriminator value never defined.", + "Doc": "Get a model containing discriminator value never defined.", "Accessibility": "public", "Parameters": [ { @@ -819,7 +819,7 @@ "$id": "72", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "73", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/nested-discriminator/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/nested-discriminator/tspCodeModel.json index 99716a6a49..6e7ddbf831 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/nested-discriminator/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/nested-discriminator/tspCodeModel.json @@ -10,14 +10,14 @@ "name": "Fish", "crossLanguageDefinitionId": "Type.Model.Inheritance.NestedDiscriminator.Fish", "usage": "Input,Output,Json", - "description": "This is base model for polymorphic multiple levels inheritance with a discriminator.", + "doc": "This is base model for polymorphic multiple levels inheritance with a discriminator.", "decorators": [], "discriminatorProperty": { "$id": "3", "kind": "property", "name": "kind", "serializedName": "kind", - "description": "Discriminator property for Fish.", + "doc": "Discriminator property for Fish.", "type": { "$id": "4", "kind": "string", @@ -64,7 +64,7 @@ "name": "Shark", "crossLanguageDefinitionId": "Type.Model.Inheritance.NestedDiscriminator.Shark", "usage": "Input,Output,Json", - "description": "The second level model in polymorphic multiple levels inheritance and it defines a new discriminator.", + "doc": "The second level model in polymorphic multiple levels inheritance and it defines a new discriminator.", "discriminatorValue": "shark", "decorators": [], "discriminatorProperty": { @@ -127,7 +127,7 @@ "name": "SawShark", "crossLanguageDefinitionId": "Type.Model.Inheritance.NestedDiscriminator.SawShark", "usage": "Input,Output,Json", - "description": "The third level model SawShark in polymorphic multiple levels inheritance.", + "doc": "The third level model SawShark in polymorphic multiple levels inheritance.", "discriminatorValue": "saw", "decorators": [], "baseModel": { @@ -167,7 +167,7 @@ "name": "GoblinShark", "crossLanguageDefinitionId": "Type.Model.Inheritance.NestedDiscriminator.GoblinShark", "usage": "Input,Output,Json", - "description": "The third level model GoblinShark in polymorphic multiple levels inheritance.", + "doc": "The third level model GoblinShark in polymorphic multiple levels inheritance.", "discriminatorValue": "goblin", "decorators": [], "baseModel": { @@ -209,7 +209,7 @@ "name": "Salmon", "crossLanguageDefinitionId": "Type.Model.Inheritance.NestedDiscriminator.Salmon", "usage": "Input,Output,Json", - "description": "The second level model in polymorphic multiple levels inheritance which contains references to other polymorphic instances.", + "doc": "The second level model in polymorphic multiple levels inheritance which contains references to other polymorphic instances.", "discriminatorValue": "salmon", "decorators": [], "baseModel": { @@ -326,7 +326,7 @@ { "$id": "33", "Name": "NestedDiscriminatorClient", - "Description": "Illustrates multiple level inheritance with multiple discriminators.", + "Doc": "Illustrates multiple level inheritance with multiple discriminators.", "Operations": [ { "$id": "34", @@ -399,7 +399,7 @@ "$id": "40", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "41", "kind": "constant", @@ -536,7 +536,7 @@ "$id": "51", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "52", "kind": "constant", @@ -733,7 +733,7 @@ "$id": "67", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "68", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/not-discriminated/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/not-discriminated/tspCodeModel.json index abe203cb12..a29b2e3566 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/not-discriminated/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/not-discriminated/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "Siamese", "crossLanguageDefinitionId": "Type.Model.Inheritance.NotDiscriminated.Siamese", "usage": "Input,Output,Json", - "description": "The third level model in the normal multiple levels inheritance.", + "doc": "The third level model in the normal multiple levels inheritance.", "decorators": [], "baseModel": { "$id": "3", @@ -18,7 +18,7 @@ "name": "Cat", "crossLanguageDefinitionId": "Type.Model.Inheritance.NotDiscriminated.Cat", "usage": "Input,Output,Json", - "description": "The second level model in the normal multiple levels inheritance.", + "doc": "The second level model in the normal multiple levels inheritance.", "decorators": [], "baseModel": { "$id": "4", @@ -26,7 +26,7 @@ "name": "Pet", "crossLanguageDefinitionId": "Type.Model.Inheritance.NotDiscriminated.Pet", "usage": "Input,Output,Json", - "description": "This is base model for not-discriminated normal multiple levels inheritance.", + "doc": "This is base model for not-discriminated normal multiple levels inheritance.", "decorators": [], "properties": [ { @@ -105,7 +105,7 @@ { "$id": "11", "Name": "NotDiscriminatedClient", - "Description": "Illustrates not-discriminated inheritance model.", + "Doc": "Illustrates not-discriminated inheritance model.", "Operations": [ { "$id": "12", @@ -117,7 +117,7 @@ "$id": "13", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "14", "kind": "constant", @@ -254,7 +254,7 @@ "$id": "24", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "25", "kind": "constant", @@ -362,7 +362,7 @@ "$id": "33", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "34", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/recursive/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/recursive/tspCodeModel.json index 209ea500b1..a612580700 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/recursive/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/recursive/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "Extension", "crossLanguageDefinitionId": "Type.Model.Inheritance.Recursive.Extension", "usage": "Input,Output,Json", - "description": "extension", + "doc": "extension", "decorators": [], "baseModel": { "$id": "3", @@ -18,7 +18,7 @@ "name": "Element", "crossLanguageDefinitionId": "Type.Model.Inheritance.Recursive.Element", "usage": "Input,Output,Json", - "description": "element", + "doc": "element", "decorators": [], "properties": [ { @@ -75,7 +75,7 @@ { "$id": "8", "Name": "RecursiveClient", - "Description": "Illustrates inheritance recursion", + "Doc": "Illustrates inheritance recursion", "Operations": [ { "$id": "9", @@ -87,7 +87,7 @@ "$id": "10", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "11", "kind": "constant", @@ -223,7 +223,7 @@ "$id": "21", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "22", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/single-discriminator/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/single-discriminator/tspCodeModel.json index 0075459cad..61d5c2e68c 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/single-discriminator/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/inheritance/single-discriminator/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "Bird", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.Bird", "usage": "Input,Output,Json", - "description": "This is base model for polymorphic single level inheritance with a discriminator.", + "doc": "This is base model for polymorphic single level inheritance with a discriminator.", "decorators": [], "discriminatorProperty": { "$id": "3", @@ -63,7 +63,7 @@ "name": "SeaGull", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.SeaGull", "usage": "Input,Output,Json", - "description": "The second level model in polymorphic single level inheritance.", + "doc": "The second level model in polymorphic single level inheritance.", "discriminatorValue": "seagull", "decorators": [], "baseModel": { @@ -103,7 +103,7 @@ "name": "Sparrow", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.Sparrow", "usage": "Input,Output,Json", - "description": "The second level model in polymorphic single level inheritance.", + "doc": "The second level model in polymorphic single level inheritance.", "discriminatorValue": "sparrow", "decorators": [], "baseModel": { @@ -143,7 +143,7 @@ "name": "Goose", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.Goose", "usage": "Input,Output,Json", - "description": "The second level model in polymorphic single level inheritance.", + "doc": "The second level model in polymorphic single level inheritance.", "discriminatorValue": "goose", "decorators": [], "baseModel": { @@ -183,7 +183,7 @@ "name": "Eagle", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.Eagle", "usage": "Input,Output,Json", - "description": "The second level model in polymorphic single levels inheritance which contains references to other polymorphic instances.", + "doc": "The second level model in polymorphic single levels inheritance which contains references to other polymorphic instances.", "discriminatorValue": "eagle", "decorators": [], "baseModel": { @@ -301,14 +301,14 @@ "name": "Dinosaur", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.Dinosaur", "usage": "Output,Json", - "description": "Define a base class in the legacy way. Discriminator property is not explicitly defined in the model.", + "doc": "Define a base class in the legacy way. Discriminator property is not explicitly defined in the model.", "decorators": [], "discriminatorProperty": { "$id": "31", "kind": "property", "name": "kind", "serializedName": "kind", - "description": "Discriminator property for Dinosaur.", + "doc": "Discriminator property for Dinosaur.", "type": { "$id": "32", "kind": "string", @@ -355,7 +355,7 @@ "name": "TRex", "crossLanguageDefinitionId": "Type.Model.Inheritance.SingleDiscriminator.TRex", "usage": "Output,Json", - "description": "The second level legacy model in polymorphic single level inheritance.", + "doc": "The second level legacy model in polymorphic single level inheritance.", "discriminatorValue": "t-rex", "decorators": [], "baseModel": { @@ -399,7 +399,7 @@ { "$id": "40", "Name": "SingleDiscriminatorClient", - "Description": "Illustrates inheritance with single discriminator.", + "Doc": "Illustrates inheritance with single discriminator.", "Operations": [ { "$id": "41", @@ -472,7 +472,7 @@ "$id": "47", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "48", "kind": "constant", @@ -609,7 +609,7 @@ "$id": "58", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "59", "kind": "constant", @@ -867,7 +867,7 @@ "$id": "79", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "80", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/usage/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/usage/tspCodeModel.json index e73fd5363e..88e7279715 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/usage/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/usage/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "InputRecord", "crossLanguageDefinitionId": "Type.Model.Usage.InputRecord", "usage": "Input,Json", - "description": "Record used in operation parameters", + "doc": "Record used in operation parameters", "decorators": [], "properties": [ { @@ -40,7 +40,7 @@ "name": "OutputRecord", "crossLanguageDefinitionId": "Type.Model.Usage.OutputRecord", "usage": "Output,Json", - "description": "Record used in operation return type", + "doc": "Record used in operation return type", "decorators": [], "properties": [ { @@ -70,7 +70,7 @@ "name": "InputOutputRecord", "crossLanguageDefinitionId": "Type.Model.Usage.InputOutputRecord", "usage": "Input,Output,Json", - "description": "Record used both as operation parameter and return type", + "doc": "Record used both as operation parameter and return type", "decorators": [], "properties": [ { @@ -99,7 +99,7 @@ { "$id": "11", "Name": "UsageClient", - "Description": "Illustrates usage of Record in different places(Operation parameters, return type or both).", + "Doc": "Illustrates usage of Record in different places(Operation parameters, return type or both).", "Operations": [ { "$id": "12", @@ -111,7 +111,7 @@ "$id": "13", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "14", "kind": "constant", @@ -248,7 +248,7 @@ "$id": "24", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "25", "kind": "constant", @@ -356,7 +356,7 @@ "$id": "33", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "34", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/visibility/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/visibility/tspCodeModel.json index 54b8391348..5f3b9906f0 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/visibility/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/model/visibility/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "VisibilityModel", "crossLanguageDefinitionId": "Type.Model.Visibility.VisibilityModel", "usage": "Input,Output,Json", - "description": "Output model with visibility properties.", + "doc": "Output model with visibility properties.", "decorators": [], "properties": [ { @@ -18,7 +18,7 @@ "kind": "property", "name": "readProp", "serializedName": "readProp", - "description": "Required string, illustrating a readonly property.", + "doc": "Required string, illustrating a readonly property.", "type": { "$id": "4", "kind": "string", @@ -38,7 +38,7 @@ "kind": "property", "name": "queryProp", "serializedName": "queryProp", - "description": "Required int32, illustrating a query property.", + "doc": "Required int32, illustrating a query property.", "type": { "$id": "6", "kind": "int32", @@ -58,7 +58,7 @@ "kind": "property", "name": "createProp", "serializedName": "createProp", - "description": "Required string[], illustrating a create property.", + "doc": "Required string[], illustrating a create property.", "type": { "$id": "8", "kind": "array", @@ -85,7 +85,7 @@ "kind": "property", "name": "updateProp", "serializedName": "updateProp", - "description": "Required int32[], illustrating a update property.", + "doc": "Required int32[], illustrating a update property.", "type": { "$id": "11", "kind": "array", @@ -112,7 +112,7 @@ "kind": "property", "name": "deleteProp", "serializedName": "deleteProp", - "description": "Required bool, illustrating a delete property.", + "doc": "Required bool, illustrating a delete property.", "type": { "$id": "14", "kind": "boolean", @@ -135,7 +135,7 @@ "name": "ReadOnlyModel", "crossLanguageDefinitionId": "Type.Model.Visibility.ReadOnlyModel", "usage": "Input,Output,Json", - "description": "RoundTrip model with readonly optional properties.", + "doc": "RoundTrip model with readonly optional properties.", "decorators": [], "properties": [ { @@ -143,7 +143,7 @@ "kind": "property", "name": "optionalNullableIntList", "serializedName": "optionalNullableIntList", - "description": "Optional readonly nullable int list.", + "doc": "Optional readonly nullable int list.", "type": { "$id": "17", "kind": "nullable", @@ -174,7 +174,7 @@ "kind": "property", "name": "optionalStringRecord", "serializedName": "optionalStringRecord", - "description": "Optional readonly string dictionary.", + "doc": "Optional readonly string dictionary.", "type": { "$id": "21", "kind": "dict", @@ -208,7 +208,7 @@ { "$id": "24", "Name": "VisibilityClient", - "Description": "Illustrates models with visibility properties.", + "Doc": "Illustrates models with visibility properties.", "Operations": [ { "$id": "25", @@ -220,7 +220,7 @@ "$id": "26", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "27", "kind": "constant", @@ -329,7 +329,7 @@ "$id": "35", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "36", "kind": "constant", @@ -405,7 +405,7 @@ "$id": "41", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "42", "kind": "constant", @@ -481,7 +481,7 @@ "$id": "47", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "48", "kind": "constant", @@ -557,7 +557,7 @@ "$id": "53", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "54", "kind": "constant", @@ -633,7 +633,7 @@ "$id": "59", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "60", "kind": "constant", @@ -709,7 +709,7 @@ "$id": "65", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "66", "kind": "constant", @@ -817,7 +817,7 @@ "$id": "74", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "75", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/additional-properties/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/additional-properties/tspCodeModel.json index 878f1b8ac6..ada137f848 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/additional-properties/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/additional-properties/tspCodeModel.json @@ -20,7 +20,7 @@ "kind": "enumvalue", "name": "kind1", "value": "kind1", - "description": "kind1", + "doc": "kind1", "valueType": { "$ref": "3" }, @@ -30,7 +30,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The WidgetData2_kind", + "doc": "The WidgetData2_kind", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -53,7 +53,7 @@ "kind": "enumvalue", "name": "kind1", "value": "kind1", - "description": "kind1", + "doc": "kind1", "valueType": { "$ref": "6" }, @@ -63,7 +63,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The WidgetData1_kind", + "doc": "The WidgetData1_kind", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -86,7 +86,7 @@ "kind": "enumvalue", "name": "kind0", "value": "kind0", - "description": "kind0", + "doc": "kind0", "valueType": { "$ref": "9" }, @@ -96,7 +96,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The WidgetData0_kind", + "doc": "The WidgetData0_kind", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -110,7 +110,7 @@ "name": "SpreadRecordForNonDiscriminatedUnion3", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadRecordForNonDiscriminatedUnion3", "usage": "Input,Output,Json", - "description": "The model spread Record", + "doc": "The model spread Record", "decorators": [], "additionalProperties": { "$id": "12", @@ -268,7 +268,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "29", "kind": "string", @@ -297,7 +297,7 @@ "name": "SpreadRecordForNonDiscriminatedUnion2", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadRecordForNonDiscriminatedUnion2", "usage": "Input,Output,Json", - "description": "The model spread Record", + "doc": "The model spread Record", "decorators": [], "additionalProperties": { "$id": "31", @@ -319,7 +319,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "33", "kind": "string", @@ -342,7 +342,7 @@ "name": "SpreadRecordForNonDiscriminatedUnion", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadRecordForNonDiscriminatedUnion", "usage": "Input,Output,Json", - "description": "The model spread Record", + "doc": "The model spread Record", "decorators": [], "additionalProperties": { "$id": "35", @@ -411,7 +411,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "42", "kind": "string", @@ -437,7 +437,7 @@ "name": "SpreadRecordForDiscriminatedUnion", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadRecordForDiscriminatedUnion", "usage": "Input,Output,Json", - "description": "The model spread Record", + "doc": "The model spread Record", "decorators": [], "additionalProperties": { "$id": "44", @@ -459,7 +459,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "46", "kind": "string", @@ -482,7 +482,7 @@ "name": "SpreadRecordForUnion", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadRecordForUnion", "usage": "Input,Output,Json", - "description": "The model spread Record", + "doc": "The model spread Record", "decorators": [], "additionalProperties": { "$id": "48", @@ -512,7 +512,7 @@ "kind": "property", "name": "flag", "serializedName": "flag", - "description": "The name property", + "doc": "The name property", "type": { "$id": "52", "kind": "boolean", @@ -535,7 +535,7 @@ "name": "MultipleSpreadRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.MultipleSpreadRecord", "usage": "Input,Output,Json", - "description": "The model spread Record and Record", + "doc": "The model spread Record and Record", "decorators": [], "additionalProperties": { "$id": "54", @@ -565,7 +565,7 @@ "kind": "property", "name": "flag", "serializedName": "flag", - "description": "The name property", + "doc": "The name property", "type": { "$id": "58", "kind": "boolean", @@ -588,7 +588,7 @@ "name": "DifferentSpreadModelArrayDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadModelArrayDerived", "usage": "Input,Output,Json", - "description": "The model extends from a model that spread Record with the different known property type", + "doc": "The model extends from a model that spread Record with the different known property type", "decorators": [], "baseModel": { "$id": "60", @@ -596,7 +596,7 @@ "name": "DifferentSpreadModelArrayRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadModelArrayRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the different known property type", + "doc": "The model spread Record with the different known property type", "decorators": [], "additionalProperties": { "$id": "61", @@ -608,7 +608,7 @@ "name": "ModelForRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ModelForRecord", "usage": "Input,Output,Json", - "description": "model for record", + "doc": "model for record", "decorators": [], "properties": [ { @@ -616,7 +616,7 @@ "kind": "property", "name": "state", "serializedName": "state", - "description": "The state property", + "doc": "The state property", "type": { "$id": "64", "kind": "string", @@ -664,7 +664,7 @@ "kind": "property", "name": "derivedProp", "serializedName": "derivedProp", - "description": "The index property", + "doc": "The index property", "type": { "$id": "68", "kind": "array", @@ -696,7 +696,7 @@ "name": "DifferentSpreadModelDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadModelDerived", "usage": "Input,Output,Json", - "description": "The model extends from a model that spread Record with the different known property type", + "doc": "The model extends from a model that spread Record with the different known property type", "decorators": [], "baseModel": { "$id": "70", @@ -704,7 +704,7 @@ "name": "DifferentSpreadModelRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadModelRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the different known property type", + "doc": "The model spread Record with the different known property type", "decorators": [], "additionalProperties": { "$ref": "62" @@ -737,7 +737,7 @@ "kind": "property", "name": "derivedProp", "serializedName": "derivedProp", - "description": "The index property", + "doc": "The index property", "type": { "$ref": "62" }, @@ -759,7 +759,7 @@ "name": "DifferentSpreadFloatDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadFloatDerived", "usage": "Input,Output,Json", - "description": "The model extends from a model that spread Record with the different known property type", + "doc": "The model extends from a model that spread Record with the different known property type", "decorators": [], "baseModel": { "$id": "75", @@ -767,7 +767,7 @@ "name": "DifferentSpreadFloatRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadFloatRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the different known property type", + "doc": "The model spread Record with the different known property type", "decorators": [], "additionalProperties": { "$id": "76", @@ -782,7 +782,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The id property", + "doc": "The id property", "type": { "$id": "78", "kind": "string", @@ -805,7 +805,7 @@ "kind": "property", "name": "derivedProp", "serializedName": "derivedProp", - "description": "The index property", + "doc": "The index property", "type": { "$id": "80", "kind": "float32", @@ -831,7 +831,7 @@ "name": "DifferentSpreadStringDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadStringDerived", "usage": "Input,Output,Json", - "description": "The model extends from a model that spread Record with the different known property type", + "doc": "The model extends from a model that spread Record with the different known property type", "decorators": [], "baseModel": { "$id": "82", @@ -839,7 +839,7 @@ "name": "DifferentSpreadStringRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.DifferentSpreadStringRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the different known property type", + "doc": "The model spread Record with the different known property type", "decorators": [], "additionalProperties": { "$id": "83", @@ -854,7 +854,7 @@ "kind": "property", "name": "id", "serializedName": "id", - "description": "The name property", + "doc": "The name property", "type": { "$id": "85", "kind": "float32", @@ -877,7 +877,7 @@ "kind": "property", "name": "derivedProp", "serializedName": "derivedProp", - "description": "The index property", + "doc": "The index property", "type": { "$id": "87", "kind": "string", @@ -945,7 +945,7 @@ "name": "IsModelArrayAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsModelArrayAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model is from Record type.", + "doc": "The model is from Record type.", "decorators": [], "additionalProperties": { "$id": "93", @@ -988,7 +988,7 @@ "name": "ExtendsModelArrayAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsModelArrayAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model extends from Record type.", + "doc": "The model extends from Record type.", "decorators": [], "additionalProperties": { "$id": "97", @@ -1031,7 +1031,7 @@ "name": "SpreadModelRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadModelRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the same known property type", + "doc": "The model spread Record with the same known property type", "decorators": [], "additionalProperties": { "$ref": "62" @@ -1060,7 +1060,7 @@ "name": "IsModelAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsModelAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model is from Record type.", + "doc": "The model is from Record type.", "decorators": [], "additionalProperties": { "$ref": "62" @@ -1089,7 +1089,7 @@ "name": "ExtendsModelAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsModelAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model extends from Record type.", + "doc": "The model extends from Record type.", "decorators": [], "additionalProperties": { "$ref": "62" @@ -1118,7 +1118,7 @@ "name": "SpreadFloatRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadFloatRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the same known property type", + "doc": "The model spread Record with the same known property type", "decorators": [], "additionalProperties": { "$id": "107", @@ -1133,7 +1133,7 @@ "kind": "property", "name": "id", "serializedName": "id", - "description": "The id property", + "doc": "The id property", "type": { "$id": "109", "kind": "float32", @@ -1156,7 +1156,7 @@ "name": "IsFloatAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsFloatAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model is from Record type.", + "doc": "The model is from Record type.", "decorators": [], "additionalProperties": { "$id": "111", @@ -1171,7 +1171,7 @@ "kind": "property", "name": "id", "serializedName": "id", - "description": "The id property", + "doc": "The id property", "type": { "$id": "113", "kind": "float32", @@ -1194,7 +1194,7 @@ "name": "ExtendsFloatAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsFloatAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model extends from Record type.", + "doc": "The model extends from Record type.", "decorators": [], "additionalProperties": { "$id": "115", @@ -1209,7 +1209,7 @@ "kind": "property", "name": "id", "serializedName": "id", - "description": "The id property", + "doc": "The id property", "type": { "$id": "117", "kind": "float32", @@ -1232,7 +1232,7 @@ "name": "SpreadStringRecord", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.SpreadStringRecord", "usage": "Input,Output,Json", - "description": "The model spread Record with the same known property type", + "doc": "The model spread Record with the same known property type", "decorators": [], "additionalProperties": { "$id": "119", @@ -1247,7 +1247,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "121", "kind": "string", @@ -1270,7 +1270,7 @@ "name": "IsStringAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsStringAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model is from Record type.", + "doc": "The model is from Record type.", "decorators": [], "additionalProperties": { "$id": "123", @@ -1285,7 +1285,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "125", "kind": "string", @@ -1308,7 +1308,7 @@ "name": "ExtendsStringAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsStringAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model extends from Record type.", + "doc": "The model extends from Record type.", "decorators": [], "additionalProperties": { "$id": "127", @@ -1323,7 +1323,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "129", "kind": "string", @@ -1346,7 +1346,7 @@ "name": "IsUnknownAdditionalPropertiesDiscriminated", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsUnknownAdditionalPropertiesDiscriminated", "usage": "Input,Output,Json", - "description": "The model is Record with a discriminator.", + "doc": "The model is Record with a discriminator.", "decorators": [], "additionalProperties": { "$id": "131", @@ -1360,7 +1360,7 @@ "kind": "property", "name": "kind", "serializedName": "kind", - "description": "The discriminator", + "doc": "The discriminator", "type": { "$id": "133", "kind": "string", @@ -1381,7 +1381,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "135", "kind": "string", @@ -1408,7 +1408,7 @@ "name": "IsUnknownAdditionalPropertiesDiscriminatedDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsUnknownAdditionalPropertiesDiscriminatedDerived", "usage": "Input,Output,Json", - "description": "The derived discriminated type", + "doc": "The derived discriminated type", "discriminatorValue": "derived", "decorators": [], "baseModel": { @@ -1445,7 +1445,7 @@ "kind": "property", "name": "index", "serializedName": "index", - "description": "The index property", + "doc": "The index property", "type": { "$id": "142", "kind": "int32", @@ -1465,7 +1465,7 @@ "kind": "property", "name": "age", "serializedName": "age", - "description": "The age property", + "doc": "The age property", "type": { "$id": "144", "kind": "float32", @@ -1493,7 +1493,7 @@ "name": "IsUnknownAdditionalPropertiesDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsUnknownAdditionalPropertiesDerived", "usage": "Input,Output,Json", - "description": "The model extends from a type that is Record type", + "doc": "The model extends from a type that is Record type", "decorators": [], "baseModel": { "$id": "146", @@ -1501,7 +1501,7 @@ "name": "IsUnknownAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.IsUnknownAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model is from Record type.", + "doc": "The model is from Record type.", "decorators": [], "additionalProperties": { "$id": "147", @@ -1516,7 +1516,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "149", "kind": "string", @@ -1539,7 +1539,7 @@ "kind": "property", "name": "index", "serializedName": "index", - "description": "The index property", + "doc": "The index property", "type": { "$id": "151", "kind": "int32", @@ -1559,7 +1559,7 @@ "kind": "property", "name": "age", "serializedName": "age", - "description": "The age property", + "doc": "The age property", "type": { "$id": "153", "kind": "float32", @@ -1585,7 +1585,7 @@ "name": "ExtendsUnknownAdditionalPropertiesDiscriminated", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsUnknownAdditionalPropertiesDiscriminated", "usage": "Input,Output,Json", - "description": "The model extends from Record with a discriminator.", + "doc": "The model extends from Record with a discriminator.", "decorators": [], "additionalProperties": { "$id": "155", @@ -1599,7 +1599,7 @@ "kind": "property", "name": "kind", "serializedName": "kind", - "description": "The discriminator", + "doc": "The discriminator", "type": { "$id": "157", "kind": "string", @@ -1620,7 +1620,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "159", "kind": "string", @@ -1647,7 +1647,7 @@ "name": "ExtendsUnknownAdditionalPropertiesDiscriminatedDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsUnknownAdditionalPropertiesDiscriminatedDerived", "usage": "Input,Output,Json", - "description": "The derived discriminated type", + "doc": "The derived discriminated type", "discriminatorValue": "derived", "decorators": [], "baseModel": { @@ -1684,7 +1684,7 @@ "kind": "property", "name": "index", "serializedName": "index", - "description": "The index property", + "doc": "The index property", "type": { "$id": "166", "kind": "int32", @@ -1704,7 +1704,7 @@ "kind": "property", "name": "age", "serializedName": "age", - "description": "The age property", + "doc": "The age property", "type": { "$id": "168", "kind": "float32", @@ -1732,7 +1732,7 @@ "name": "ExtendsUnknownAdditionalPropertiesDerived", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsUnknownAdditionalPropertiesDerived", "usage": "Input,Output,Json", - "description": "The model extends from a type that extends from Record.", + "doc": "The model extends from a type that extends from Record.", "decorators": [], "baseModel": { "$id": "170", @@ -1740,7 +1740,7 @@ "name": "ExtendsUnknownAdditionalProperties", "crossLanguageDefinitionId": "Type.Property.AdditionalProperties.ExtendsUnknownAdditionalProperties", "usage": "Input,Output,Json", - "description": "The model extends from Record type.", + "doc": "The model extends from Record type.", "decorators": [], "additionalProperties": { "$id": "171", @@ -1755,7 +1755,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "The name property", + "doc": "The name property", "type": { "$id": "173", "kind": "string", @@ -1778,7 +1778,7 @@ "kind": "property", "name": "index", "serializedName": "index", - "description": "The index property", + "doc": "The index property", "type": { "$id": "175", "kind": "int32", @@ -1798,7 +1798,7 @@ "kind": "property", "name": "age", "serializedName": "age", - "description": "The age property", + "doc": "The age property", "type": { "$id": "177", "kind": "float32", @@ -1823,7 +1823,7 @@ { "$id": "178", "Name": "AdditionalPropertiesClient", - "Description": "Tests for additional properties of models", + "Doc": "Tests for additional properties of models", "Operations": [], "Protocol": { "$id": "179" @@ -1833,7 +1833,7 @@ "$id": "180", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "181", "kind": "url", @@ -1871,7 +1871,7 @@ "$id": "185", "Name": "get", "ResourceName": "ExtendsUnknown", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -1933,14 +1933,14 @@ "$id": "190", "Name": "put", "ResourceName": "ExtendsUnknown", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "191", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "192", "kind": "constant", @@ -1968,7 +1968,7 @@ "$id": "194", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "170" }, @@ -2017,7 +2017,7 @@ "$id": "197", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "198", "kind": "url", @@ -2055,7 +2055,7 @@ "$id": "202", "Name": "get", "ResourceName": "ExtendsUnknownDerived", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2117,14 +2117,14 @@ "$id": "207", "Name": "put", "ResourceName": "ExtendsUnknownDerived", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "208", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "209", "kind": "constant", @@ -2152,7 +2152,7 @@ "$id": "211", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "169" }, @@ -2201,7 +2201,7 @@ "$id": "214", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "215", "kind": "url", @@ -2239,7 +2239,7 @@ "$id": "219", "Name": "get", "ResourceName": "ExtendsUnknownDiscriminated", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2301,14 +2301,14 @@ "$id": "224", "Name": "put", "ResourceName": "ExtendsUnknownDiscriminated", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "225", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "226", "kind": "constant", @@ -2336,7 +2336,7 @@ "$id": "228", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "154" }, @@ -2385,7 +2385,7 @@ "$id": "231", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "232", "kind": "url", @@ -2423,7 +2423,7 @@ "$id": "236", "Name": "get", "ResourceName": "IsUnknown", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2485,14 +2485,14 @@ "$id": "241", "Name": "put", "ResourceName": "IsUnknown", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "242", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "243", "kind": "constant", @@ -2520,7 +2520,7 @@ "$id": "245", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "146" }, @@ -2569,7 +2569,7 @@ "$id": "248", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "249", "kind": "url", @@ -2607,7 +2607,7 @@ "$id": "253", "Name": "get", "ResourceName": "IsUnknownDerived", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2669,14 +2669,14 @@ "$id": "258", "Name": "put", "ResourceName": "IsUnknownDerived", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "259", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "260", "kind": "constant", @@ -2704,7 +2704,7 @@ "$id": "262", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "145" }, @@ -2753,7 +2753,7 @@ "$id": "265", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "266", "kind": "url", @@ -2791,7 +2791,7 @@ "$id": "270", "Name": "get", "ResourceName": "IsUnknownDiscriminated", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2853,14 +2853,14 @@ "$id": "275", "Name": "put", "ResourceName": "IsUnknownDiscriminated", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "276", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "277", "kind": "constant", @@ -2888,7 +2888,7 @@ "$id": "279", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "130" }, @@ -2937,7 +2937,7 @@ "$id": "282", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "283", "kind": "url", @@ -2975,7 +2975,7 @@ "$id": "287", "Name": "get", "ResourceName": "ExtendsString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3037,14 +3037,14 @@ "$id": "292", "Name": "put", "ResourceName": "ExtendsString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "293", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "294", "kind": "constant", @@ -3072,7 +3072,7 @@ "$id": "296", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "126" }, @@ -3121,7 +3121,7 @@ "$id": "299", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "300", "kind": "url", @@ -3159,7 +3159,7 @@ "$id": "304", "Name": "get", "ResourceName": "IsString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3221,14 +3221,14 @@ "$id": "309", "Name": "put", "ResourceName": "IsString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "310", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "311", "kind": "constant", @@ -3256,7 +3256,7 @@ "$id": "313", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "122" }, @@ -3305,7 +3305,7 @@ "$id": "316", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "317", "kind": "url", @@ -3343,7 +3343,7 @@ "$id": "321", "Name": "get", "ResourceName": "SpreadString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3405,14 +3405,14 @@ "$id": "326", "Name": "put", "ResourceName": "SpreadString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "327", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "328", "kind": "constant", @@ -3440,7 +3440,7 @@ "$id": "330", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "118" }, @@ -3489,7 +3489,7 @@ "$id": "333", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "334", "kind": "url", @@ -3527,7 +3527,7 @@ "$id": "338", "Name": "get", "ResourceName": "ExtendsFloat", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3589,14 +3589,14 @@ "$id": "343", "Name": "put", "ResourceName": "ExtendsFloat", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "344", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "345", "kind": "constant", @@ -3624,7 +3624,7 @@ "$id": "347", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "114" }, @@ -3673,7 +3673,7 @@ "$id": "350", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "351", "kind": "url", @@ -3711,7 +3711,7 @@ "$id": "355", "Name": "get", "ResourceName": "IsFloat", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3773,14 +3773,14 @@ "$id": "360", "Name": "put", "ResourceName": "IsFloat", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "361", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "362", "kind": "constant", @@ -3808,7 +3808,7 @@ "$id": "364", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "110" }, @@ -3857,7 +3857,7 @@ "$id": "367", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "368", "kind": "url", @@ -3895,7 +3895,7 @@ "$id": "372", "Name": "get", "ResourceName": "SpreadFloat", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3957,14 +3957,14 @@ "$id": "377", "Name": "put", "ResourceName": "SpreadFloat", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "378", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "379", "kind": "constant", @@ -3992,7 +3992,7 @@ "$id": "381", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "106" }, @@ -4041,7 +4041,7 @@ "$id": "384", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "385", "kind": "url", @@ -4079,7 +4079,7 @@ "$id": "389", "Name": "get", "ResourceName": "ExtendsModel", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4141,14 +4141,14 @@ "$id": "394", "Name": "put", "ResourceName": "ExtendsModel", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "395", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "396", "kind": "constant", @@ -4176,7 +4176,7 @@ "$id": "398", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "104" }, @@ -4225,7 +4225,7 @@ "$id": "401", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "402", "kind": "url", @@ -4263,7 +4263,7 @@ "$id": "406", "Name": "get", "ResourceName": "IsModel", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4325,14 +4325,14 @@ "$id": "411", "Name": "put", "ResourceName": "IsModel", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "412", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "413", "kind": "constant", @@ -4360,7 +4360,7 @@ "$id": "415", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "102" }, @@ -4409,7 +4409,7 @@ "$id": "418", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "419", "kind": "url", @@ -4447,7 +4447,7 @@ "$id": "423", "Name": "get", "ResourceName": "SpreadModel", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4509,14 +4509,14 @@ "$id": "428", "Name": "put", "ResourceName": "SpreadModel", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "429", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "430", "kind": "constant", @@ -4544,7 +4544,7 @@ "$id": "432", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "100" }, @@ -4593,7 +4593,7 @@ "$id": "435", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "436", "kind": "url", @@ -4631,7 +4631,7 @@ "$id": "440", "Name": "get", "ResourceName": "ExtendsModelArray", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4693,14 +4693,14 @@ "$id": "445", "Name": "put", "ResourceName": "ExtendsModelArray", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "446", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "447", "kind": "constant", @@ -4728,7 +4728,7 @@ "$id": "449", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "96" }, @@ -4777,7 +4777,7 @@ "$id": "452", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "453", "kind": "url", @@ -4815,7 +4815,7 @@ "$id": "457", "Name": "get", "ResourceName": "IsModelArray", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4877,14 +4877,14 @@ "$id": "462", "Name": "put", "ResourceName": "IsModelArray", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "463", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "464", "kind": "constant", @@ -4912,7 +4912,7 @@ "$id": "466", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "92" }, @@ -4961,7 +4961,7 @@ "$id": "469", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "470", "kind": "url", @@ -4999,7 +4999,7 @@ "$id": "474", "Name": "get", "ResourceName": "SpreadModelArray", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5061,14 +5061,14 @@ "$id": "479", "Name": "put", "ResourceName": "SpreadModelArray", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "480", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "481", "kind": "constant", @@ -5096,7 +5096,7 @@ "$id": "483", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "88" }, @@ -5145,7 +5145,7 @@ "$id": "486", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "487", "kind": "url", @@ -5183,7 +5183,7 @@ "$id": "491", "Name": "get", "ResourceName": "SpreadDifferentString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5245,14 +5245,14 @@ "$id": "496", "Name": "put", "ResourceName": "SpreadDifferentString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "497", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "498", "kind": "constant", @@ -5280,7 +5280,7 @@ "$id": "500", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "82" }, @@ -5329,7 +5329,7 @@ "$id": "503", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "504", "kind": "url", @@ -5367,7 +5367,7 @@ "$id": "508", "Name": "get", "ResourceName": "SpreadDifferentFloat", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5429,14 +5429,14 @@ "$id": "513", "Name": "put", "ResourceName": "SpreadDifferentFloat", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "514", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "515", "kind": "constant", @@ -5464,7 +5464,7 @@ "$id": "517", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "75" }, @@ -5513,7 +5513,7 @@ "$id": "520", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "521", "kind": "url", @@ -5551,7 +5551,7 @@ "$id": "525", "Name": "get", "ResourceName": "SpreadDifferentModel", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5613,14 +5613,14 @@ "$id": "530", "Name": "put", "ResourceName": "SpreadDifferentModel", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "531", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "532", "kind": "constant", @@ -5648,7 +5648,7 @@ "$id": "534", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "70" }, @@ -5697,7 +5697,7 @@ "$id": "537", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "538", "kind": "url", @@ -5735,7 +5735,7 @@ "$id": "542", "Name": "get", "ResourceName": "SpreadDifferentModelArray", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5797,14 +5797,14 @@ "$id": "547", "Name": "put", "ResourceName": "SpreadDifferentModelArray", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "548", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "549", "kind": "constant", @@ -5832,7 +5832,7 @@ "$id": "551", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "60" }, @@ -5881,7 +5881,7 @@ "$id": "554", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "555", "kind": "url", @@ -5919,7 +5919,7 @@ "$id": "559", "Name": "get", "ResourceName": "ExtendsDifferentSpreadString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5981,14 +5981,14 @@ "$id": "564", "Name": "put", "ResourceName": "ExtendsDifferentSpreadString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "565", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "566", "kind": "constant", @@ -6016,7 +6016,7 @@ "$id": "568", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "81" }, @@ -6065,7 +6065,7 @@ "$id": "571", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "572", "kind": "url", @@ -6103,7 +6103,7 @@ "$id": "576", "Name": "get", "ResourceName": "ExtendsDifferentSpreadFloat", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6165,14 +6165,14 @@ "$id": "581", "Name": "put", "ResourceName": "ExtendsDifferentSpreadFloat", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "582", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "583", "kind": "constant", @@ -6200,7 +6200,7 @@ "$id": "585", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "74" }, @@ -6249,7 +6249,7 @@ "$id": "588", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "589", "kind": "url", @@ -6287,7 +6287,7 @@ "$id": "593", "Name": "get", "ResourceName": "ExtendsDifferentSpreadModel", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6349,14 +6349,14 @@ "$id": "598", "Name": "put", "ResourceName": "ExtendsDifferentSpreadModel", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "599", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "600", "kind": "constant", @@ -6384,7 +6384,7 @@ "$id": "602", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "69" }, @@ -6433,7 +6433,7 @@ "$id": "605", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "606", "kind": "url", @@ -6471,7 +6471,7 @@ "$id": "610", "Name": "get", "ResourceName": "ExtendsDifferentSpreadModelArray", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6533,14 +6533,14 @@ "$id": "615", "Name": "put", "ResourceName": "ExtendsDifferentSpreadModelArray", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "616", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "617", "kind": "constant", @@ -6568,7 +6568,7 @@ "$id": "619", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "59" }, @@ -6617,7 +6617,7 @@ "$id": "622", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "623", "kind": "url", @@ -6655,7 +6655,7 @@ "$id": "627", "Name": "get", "ResourceName": "MultipleSpread", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6717,14 +6717,14 @@ "$id": "632", "Name": "put", "ResourceName": "MultipleSpread", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "633", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "634", "kind": "constant", @@ -6752,7 +6752,7 @@ "$id": "636", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "53" }, @@ -6801,7 +6801,7 @@ "$id": "639", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "640", "kind": "url", @@ -6839,7 +6839,7 @@ "$id": "644", "Name": "get", "ResourceName": "SpreadRecordUnion", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6901,14 +6901,14 @@ "$id": "649", "Name": "put", "ResourceName": "SpreadRecordUnion", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "650", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "651", "kind": "constant", @@ -6936,7 +6936,7 @@ "$id": "653", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "47" }, @@ -6985,7 +6985,7 @@ "$id": "656", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "657", "kind": "url", @@ -7023,7 +7023,7 @@ "$id": "661", "Name": "get", "ResourceName": "SpreadRecordDiscriminatedUnion", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -7085,14 +7085,14 @@ "$id": "666", "Name": "put", "ResourceName": "SpreadRecordDiscriminatedUnion", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "667", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "668", "kind": "constant", @@ -7120,7 +7120,7 @@ "$id": "670", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "43" }, @@ -7169,7 +7169,7 @@ "$id": "673", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "674", "kind": "url", @@ -7207,7 +7207,7 @@ "$id": "678", "Name": "get", "ResourceName": "SpreadRecordNonDiscriminatedUnion", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -7269,14 +7269,14 @@ "$id": "683", "Name": "put", "ResourceName": "SpreadRecordNonDiscriminatedUnion", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "684", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "685", "kind": "constant", @@ -7304,7 +7304,7 @@ "$id": "687", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "34" }, @@ -7353,7 +7353,7 @@ "$id": "690", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "691", "kind": "url", @@ -7391,7 +7391,7 @@ "$id": "695", "Name": "get", "ResourceName": "SpreadRecordNonDiscriminatedUnion2", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -7453,14 +7453,14 @@ "$id": "700", "Name": "put", "ResourceName": "SpreadRecordNonDiscriminatedUnion2", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "701", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "702", "kind": "constant", @@ -7488,7 +7488,7 @@ "$id": "704", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "30" }, @@ -7537,7 +7537,7 @@ "$id": "707", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "708", "kind": "url", @@ -7575,7 +7575,7 @@ "$id": "712", "Name": "get", "ResourceName": "SpreadRecordNonDiscriminatedUnion3", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -7637,14 +7637,14 @@ "$id": "717", "Name": "put", "ResourceName": "SpreadRecordNonDiscriminatedUnion3", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "718", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "719", "kind": "constant", @@ -7672,7 +7672,7 @@ "$id": "721", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "11" }, @@ -7721,7 +7721,7 @@ "$id": "724", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "725", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/nullable/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/nullable/tspCodeModel.json index a5874cb31e..14e97db887 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/nullable/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/nullable/tspCodeModel.json @@ -10,7 +10,7 @@ "name": "CollectionsStringProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.CollectionsStringProperty", "usage": "Input,Output,JsonMergePatch,Json", - "description": "Model with collection string properties", + "doc": "Model with collection string properties", "decorators": [], "properties": [ { @@ -18,7 +18,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "4", "kind": "string", @@ -38,7 +38,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "6", "kind": "nullable", @@ -72,7 +72,7 @@ "name": "CollectionsModelProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.CollectionsModelProperty", "usage": "Output,Json", - "description": "Model with collection models properties", + "doc": "Model with collection models properties", "decorators": [], "properties": [ { @@ -80,7 +80,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "11", "kind": "string", @@ -100,7 +100,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "13", "kind": "nullable", @@ -114,7 +114,7 @@ "name": "InnerModel", "crossLanguageDefinitionId": "Type.Property.Nullable.InnerModel", "usage": "Output,Json", - "description": "Inner model used in collections model property", + "doc": "Inner model used in collections model property", "decorators": [], "properties": [ { @@ -122,7 +122,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Inner model property", + "doc": "Inner model property", "type": { "$id": "17", "kind": "string", @@ -161,7 +161,7 @@ "name": "CollectionsByteProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.CollectionsByteProperty", "usage": "Output,Json", - "description": "Model with collection bytes properties", + "doc": "Model with collection bytes properties", "decorators": [], "properties": [ { @@ -169,7 +169,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "20", "kind": "string", @@ -189,7 +189,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "22", "kind": "nullable", @@ -224,7 +224,7 @@ "name": "DurationProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.DurationProperty", "usage": "Output,Json", - "description": "Model with a duration property", + "doc": "Model with a duration property", "decorators": [], "properties": [ { @@ -232,7 +232,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "27", "kind": "string", @@ -252,7 +252,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "29", "kind": "nullable", @@ -287,7 +287,7 @@ "name": "DatetimeProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.DatetimeProperty", "usage": "Output,Json", - "description": "Model with a datetime property", + "doc": "Model with a datetime property", "decorators": [], "properties": [ { @@ -295,7 +295,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "34", "kind": "string", @@ -315,7 +315,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "36", "kind": "nullable", @@ -350,7 +350,7 @@ "name": "BytesProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.BytesProperty", "usage": "Output,Json", - "description": "Template type for testing models with nullable property. Pass in the type of the property you are looking for", + "doc": "Template type for testing models with nullable property. Pass in the type of the property you are looking for", "decorators": [], "properties": [ { @@ -358,7 +358,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "41", "kind": "string", @@ -378,7 +378,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "43", "kind": "nullable", @@ -406,7 +406,7 @@ "name": "StringProperty", "crossLanguageDefinitionId": "Type.Property.Nullable.StringProperty", "usage": "Output,Json", - "description": "Template type for testing models with nullable property. Pass in the type of the property you are looking for", + "doc": "Template type for testing models with nullable property. Pass in the type of the property you are looking for", "decorators": [], "properties": [ { @@ -414,7 +414,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "Required property", + "doc": "Required property", "type": { "$id": "47", "kind": "string", @@ -434,7 +434,7 @@ "kind": "property", "name": "nullableProperty", "serializedName": "nullableProperty", - "description": "Property", + "doc": "Property", "type": { "$id": "49", "kind": "nullable", @@ -460,7 +460,7 @@ { "$id": "51", "Name": "NullableClient", - "Description": "Illustrates models with nullable properties.", + "Doc": "Illustrates models with nullable properties.", "Operations": [], "Protocol": { "$id": "52" @@ -470,7 +470,7 @@ "$id": "53", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "54", "kind": "url", @@ -508,7 +508,7 @@ "$id": "58", "Name": "getNonNull", "ResourceName": "String", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -570,7 +570,7 @@ "$id": "63", "Name": "getNull", "ResourceName": "String", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -632,14 +632,14 @@ "$id": "68", "Name": "patchNonNull", "ResourceName": "String", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "69", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "70", "kind": "constant", @@ -709,14 +709,14 @@ "$id": "74", "Name": "patchNull", "ResourceName": "String", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "75", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "76", "kind": "constant", @@ -792,7 +792,7 @@ "$id": "81", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "82", "kind": "url", @@ -830,7 +830,7 @@ "$id": "86", "Name": "getNonNull", "ResourceName": "Bytes", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -892,7 +892,7 @@ "$id": "91", "Name": "getNull", "ResourceName": "Bytes", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -954,14 +954,14 @@ "$id": "96", "Name": "patchNonNull", "ResourceName": "Bytes", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "97", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "98", "kind": "constant", @@ -1031,14 +1031,14 @@ "$id": "102", "Name": "patchNull", "ResourceName": "Bytes", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "103", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "104", "kind": "constant", @@ -1114,7 +1114,7 @@ "$id": "109", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "110", "kind": "url", @@ -1152,7 +1152,7 @@ "$id": "114", "Name": "getNonNull", "ResourceName": "Datetime", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -1214,7 +1214,7 @@ "$id": "119", "Name": "getNull", "ResourceName": "Datetime", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -1276,14 +1276,14 @@ "$id": "124", "Name": "patchNonNull", "ResourceName": "Datetime", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "125", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "126", "kind": "constant", @@ -1353,14 +1353,14 @@ "$id": "130", "Name": "patchNull", "ResourceName": "Datetime", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "131", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "132", "kind": "constant", @@ -1436,7 +1436,7 @@ "$id": "137", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "138", "kind": "url", @@ -1474,7 +1474,7 @@ "$id": "142", "Name": "getNonNull", "ResourceName": "Duration", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -1536,7 +1536,7 @@ "$id": "147", "Name": "getNull", "ResourceName": "Duration", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -1598,14 +1598,14 @@ "$id": "152", "Name": "patchNonNull", "ResourceName": "Duration", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "153", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "154", "kind": "constant", @@ -1675,14 +1675,14 @@ "$id": "158", "Name": "patchNull", "ResourceName": "Duration", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "159", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "160", "kind": "constant", @@ -1758,7 +1758,7 @@ "$id": "165", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "166", "kind": "url", @@ -1796,7 +1796,7 @@ "$id": "170", "Name": "getNonNull", "ResourceName": "CollectionsByte", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -1858,7 +1858,7 @@ "$id": "175", "Name": "getNull", "ResourceName": "CollectionsByte", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -1920,14 +1920,14 @@ "$id": "180", "Name": "patchNonNull", "ResourceName": "CollectionsByte", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "181", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "182", "kind": "constant", @@ -1997,14 +1997,14 @@ "$id": "186", "Name": "patchNull", "ResourceName": "CollectionsByte", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "187", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "188", "kind": "constant", @@ -2080,7 +2080,7 @@ "$id": "193", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "194", "kind": "url", @@ -2118,7 +2118,7 @@ "$id": "198", "Name": "getNonNull", "ResourceName": "CollectionsModel", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -2180,7 +2180,7 @@ "$id": "203", "Name": "getNull", "ResourceName": "CollectionsModel", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -2242,14 +2242,14 @@ "$id": "208", "Name": "patchNonNull", "ResourceName": "CollectionsModel", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "209", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "210", "kind": "constant", @@ -2319,14 +2319,14 @@ "$id": "214", "Name": "patchNull", "ResourceName": "CollectionsModel", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "215", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "216", "kind": "constant", @@ -2402,7 +2402,7 @@ "$id": "221", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "222", "kind": "url", @@ -2440,7 +2440,7 @@ "$id": "226", "Name": "getNonNull", "ResourceName": "CollectionsString", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -2502,7 +2502,7 @@ "$id": "231", "Name": "getNull", "ResourceName": "CollectionsString", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -2564,14 +2564,14 @@ "$id": "236", "Name": "patchNonNull", "ResourceName": "CollectionsString", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "237", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "238", "kind": "constant", @@ -2641,14 +2641,14 @@ "$id": "242", "Name": "patchNull", "ResourceName": "CollectionsString", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "243", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "content-type is application/merge-patch+json", + "Doc": "content-type is application/merge-patch+json", "Type": { "$id": "244", "kind": "constant", @@ -2724,7 +2724,7 @@ "$id": "249", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "250", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/optionality/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/optionality/tspCodeModel.json index b19bdfff08..7b966d8806 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/optionality/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/optionality/tspCodeModel.json @@ -179,7 +179,7 @@ "kind": "enumvalue", "name": "1.25", "value": 1.25, - "description": "1.25", + "doc": "1.25", "valueType": { "$ref": "21" }, @@ -189,7 +189,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The FloatLiteralProperty_property", + "doc": "The FloatLiteralProperty_property", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -212,7 +212,7 @@ "kind": "enumvalue", "name": "1", "value": 1, - "description": "1", + "doc": "1", "valueType": { "$ref": "24" }, @@ -222,7 +222,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The IntLiteralProperty_property", + "doc": "The IntLiteralProperty_property", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -245,7 +245,7 @@ "kind": "enumvalue", "name": "hello", "value": "hello", - "description": "hello", + "doc": "hello", "valueType": { "$ref": "27" }, @@ -255,7 +255,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The StringLiteralProperty_property", + "doc": "The StringLiteralProperty_property", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -269,7 +269,7 @@ "name": "RequiredAndOptionalProperty", "crossLanguageDefinitionId": "Type.Property.Optional.RequiredAndOptionalProperty", "usage": "Input,Output,Json", - "description": "Model with required and optional properties", + "doc": "Model with required and optional properties", "decorators": [], "properties": [ { @@ -277,7 +277,7 @@ "kind": "property", "name": "optionalProperty", "serializedName": "optionalProperty", - "description": "optional string property", + "doc": "optional string property", "type": { "$id": "31", "kind": "string", @@ -297,7 +297,7 @@ "kind": "property", "name": "requiredProperty", "serializedName": "requiredProperty", - "description": "required int property", + "doc": "required int property", "type": { "$id": "33", "kind": "int32", @@ -320,7 +320,7 @@ "name": "UnionFloatLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.UnionFloatLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with union of float literal property", + "doc": "Model with union of float literal property", "decorators": [], "properties": [ { @@ -328,7 +328,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "2" }, @@ -347,7 +347,7 @@ "name": "UnionIntLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.UnionIntLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with union of int literal property", + "doc": "Model with union of int literal property", "decorators": [], "properties": [ { @@ -355,7 +355,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "8" }, @@ -374,7 +374,7 @@ "name": "UnionStringLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.UnionStringLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with union of string literal property", + "doc": "Model with union of string literal property", "decorators": [], "properties": [ { @@ -382,7 +382,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "14" }, @@ -401,7 +401,7 @@ "name": "BooleanLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.BooleanLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with boolean literal property", + "doc": "Model with boolean literal property", "decorators": [], "properties": [ { @@ -409,7 +409,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "42", "kind": "constant", @@ -438,7 +438,7 @@ "name": "FloatLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.FloatLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with float literal property", + "doc": "Model with float literal property", "decorators": [], "properties": [ { @@ -446,7 +446,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "46", "kind": "constant", @@ -471,7 +471,7 @@ "name": "IntLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.IntLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with int literal property", + "doc": "Model with int literal property", "decorators": [], "properties": [ { @@ -479,7 +479,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "49", "kind": "constant", @@ -504,7 +504,7 @@ "name": "StringLiteralProperty", "crossLanguageDefinitionId": "Type.Property.Optional.StringLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with string literal property", + "doc": "Model with string literal property", "decorators": [], "properties": [ { @@ -512,7 +512,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "52", "kind": "constant", @@ -537,7 +537,7 @@ "name": "CollectionsModelProperty", "crossLanguageDefinitionId": "Type.Property.Optional.CollectionsModelProperty", "usage": "Input,Output,Json", - "description": "Model with collection models properties", + "doc": "Model with collection models properties", "decorators": [], "properties": [ { @@ -545,7 +545,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "55", "kind": "array", @@ -556,7 +556,7 @@ "name": "StringProperty", "crossLanguageDefinitionId": "Type.Property.Optional.StringProperty", "usage": "Input,Output,Json", - "description": "Template type for testing models with optional property. Pass in the type of the property you are looking for", + "doc": "Template type for testing models with optional property. Pass in the type of the property you are looking for", "decorators": [], "properties": [ { @@ -564,7 +564,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "58", "kind": "string", @@ -602,7 +602,7 @@ "name": "CollectionsByteProperty", "crossLanguageDefinitionId": "Type.Property.Optional.CollectionsByteProperty", "usage": "Input,Output,Json", - "description": "Model with collection bytes properties", + "doc": "Model with collection bytes properties", "decorators": [], "properties": [ { @@ -610,7 +610,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "61", "kind": "array", @@ -641,7 +641,7 @@ "name": "PlainTimeProperty", "crossLanguageDefinitionId": "Type.Property.Optional.PlainTimeProperty", "usage": "Input,Output,Json", - "description": "Model with a plainTime property", + "doc": "Model with a plainTime property", "decorators": [], "properties": [ { @@ -649,7 +649,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "65", "kind": "plainTime", @@ -672,7 +672,7 @@ "name": "PlainDateProperty", "crossLanguageDefinitionId": "Type.Property.Optional.PlainDateProperty", "usage": "Input,Output,Json", - "description": "Model with a plainDate property", + "doc": "Model with a plainDate property", "decorators": [], "properties": [ { @@ -680,7 +680,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "68", "kind": "plainDate", @@ -703,7 +703,7 @@ "name": "DurationProperty", "crossLanguageDefinitionId": "Type.Property.Optional.DurationProperty", "usage": "Input,Output,Json", - "description": "Model with a duration property", + "doc": "Model with a duration property", "decorators": [], "properties": [ { @@ -711,7 +711,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "71", "kind": "duration", @@ -742,7 +742,7 @@ "name": "DatetimeProperty", "crossLanguageDefinitionId": "Type.Property.Optional.DatetimeProperty", "usage": "Input,Output,Json", - "description": "Model with a datetime property", + "doc": "Model with a datetime property", "decorators": [], "properties": [ { @@ -750,7 +750,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "75", "kind": "utcDateTime", @@ -781,7 +781,7 @@ "name": "BytesProperty", "crossLanguageDefinitionId": "Type.Property.Optional.BytesProperty", "usage": "Input,Output,Json", - "description": "Template type for testing models with optional property. Pass in the type of the property you are looking for", + "doc": "Template type for testing models with optional property. Pass in the type of the property you are looking for", "decorators": [], "properties": [ { @@ -789,7 +789,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "79", "kind": "bytes", @@ -812,7 +812,7 @@ { "$id": "80", "Name": "OptionalClient", - "Description": "Illustrates models with optional properties.", + "Doc": "Illustrates models with optional properties.", "Operations": [], "Protocol": { "$id": "81" @@ -822,7 +822,7 @@ "$id": "82", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "83", "kind": "url", @@ -860,7 +860,7 @@ "$id": "87", "Name": "getAll", "ResourceName": "String", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -922,7 +922,7 @@ "$id": "92", "Name": "getDefault", "ResourceName": "String", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -984,14 +984,14 @@ "$id": "97", "Name": "putAll", "ResourceName": "String", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "98", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "99", "kind": "constant", @@ -1061,14 +1061,14 @@ "$id": "103", "Name": "putDefault", "ResourceName": "String", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "104", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "105", "kind": "constant", @@ -1144,7 +1144,7 @@ "$id": "110", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "111", "kind": "url", @@ -1182,7 +1182,7 @@ "$id": "115", "Name": "getAll", "ResourceName": "Bytes", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -1244,7 +1244,7 @@ "$id": "120", "Name": "getDefault", "ResourceName": "Bytes", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -1306,14 +1306,14 @@ "$id": "125", "Name": "putAll", "ResourceName": "Bytes", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "126", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "127", "kind": "constant", @@ -1383,14 +1383,14 @@ "$id": "131", "Name": "putDefault", "ResourceName": "Bytes", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "132", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "133", "kind": "constant", @@ -1466,7 +1466,7 @@ "$id": "138", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "139", "kind": "url", @@ -1504,7 +1504,7 @@ "$id": "143", "Name": "getAll", "ResourceName": "Datetime", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -1566,7 +1566,7 @@ "$id": "148", "Name": "getDefault", "ResourceName": "Datetime", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -1628,14 +1628,14 @@ "$id": "153", "Name": "putAll", "ResourceName": "Datetime", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "154", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "155", "kind": "constant", @@ -1705,14 +1705,14 @@ "$id": "159", "Name": "putDefault", "ResourceName": "Datetime", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "160", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "161", "kind": "constant", @@ -1788,7 +1788,7 @@ "$id": "166", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "167", "kind": "url", @@ -1826,7 +1826,7 @@ "$id": "171", "Name": "getAll", "ResourceName": "Duration", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -1888,7 +1888,7 @@ "$id": "176", "Name": "getDefault", "ResourceName": "Duration", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -1950,14 +1950,14 @@ "$id": "181", "Name": "putAll", "ResourceName": "Duration", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "182", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "183", "kind": "constant", @@ -2027,14 +2027,14 @@ "$id": "187", "Name": "putDefault", "ResourceName": "Duration", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "188", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "189", "kind": "constant", @@ -2110,7 +2110,7 @@ "$id": "194", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "195", "kind": "url", @@ -2148,7 +2148,7 @@ "$id": "199", "Name": "getAll", "ResourceName": "PlainDate", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -2210,7 +2210,7 @@ "$id": "204", "Name": "getDefault", "ResourceName": "PlainDate", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -2272,14 +2272,14 @@ "$id": "209", "Name": "putAll", "ResourceName": "PlainDate", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "210", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "211", "kind": "constant", @@ -2349,14 +2349,14 @@ "$id": "215", "Name": "putDefault", "ResourceName": "PlainDate", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "216", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "217", "kind": "constant", @@ -2432,7 +2432,7 @@ "$id": "222", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "223", "kind": "url", @@ -2470,7 +2470,7 @@ "$id": "227", "Name": "getAll", "ResourceName": "PlainTime", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -2532,7 +2532,7 @@ "$id": "232", "Name": "getDefault", "ResourceName": "PlainTime", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -2594,14 +2594,14 @@ "$id": "237", "Name": "putAll", "ResourceName": "PlainTime", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "238", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "239", "kind": "constant", @@ -2671,14 +2671,14 @@ "$id": "243", "Name": "putDefault", "ResourceName": "PlainTime", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "244", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "245", "kind": "constant", @@ -2754,7 +2754,7 @@ "$id": "250", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "251", "kind": "url", @@ -2792,7 +2792,7 @@ "$id": "255", "Name": "getAll", "ResourceName": "CollectionsByte", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -2854,7 +2854,7 @@ "$id": "260", "Name": "getDefault", "ResourceName": "CollectionsByte", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -2916,14 +2916,14 @@ "$id": "265", "Name": "putAll", "ResourceName": "CollectionsByte", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "266", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "267", "kind": "constant", @@ -2993,14 +2993,14 @@ "$id": "271", "Name": "putDefault", "ResourceName": "CollectionsByte", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "272", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "273", "kind": "constant", @@ -3076,7 +3076,7 @@ "$id": "278", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "279", "kind": "url", @@ -3114,7 +3114,7 @@ "$id": "283", "Name": "getAll", "ResourceName": "CollectionsModel", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -3176,7 +3176,7 @@ "$id": "288", "Name": "getDefault", "ResourceName": "CollectionsModel", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -3238,14 +3238,14 @@ "$id": "293", "Name": "putAll", "ResourceName": "CollectionsModel", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "294", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "295", "kind": "constant", @@ -3315,14 +3315,14 @@ "$id": "299", "Name": "putDefault", "ResourceName": "CollectionsModel", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "300", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "301", "kind": "constant", @@ -3398,7 +3398,7 @@ "$id": "306", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "307", "kind": "url", @@ -3436,7 +3436,7 @@ "$id": "311", "Name": "getAll", "ResourceName": "StringLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -3498,7 +3498,7 @@ "$id": "316", "Name": "getDefault", "ResourceName": "StringLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -3560,14 +3560,14 @@ "$id": "321", "Name": "putAll", "ResourceName": "StringLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "322", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "323", "kind": "constant", @@ -3637,14 +3637,14 @@ "$id": "327", "Name": "putDefault", "ResourceName": "StringLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "328", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "329", "kind": "constant", @@ -3720,7 +3720,7 @@ "$id": "334", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "335", "kind": "url", @@ -3758,7 +3758,7 @@ "$id": "339", "Name": "getAll", "ResourceName": "IntLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -3820,7 +3820,7 @@ "$id": "344", "Name": "getDefault", "ResourceName": "IntLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -3882,14 +3882,14 @@ "$id": "349", "Name": "putAll", "ResourceName": "IntLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "350", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "351", "kind": "constant", @@ -3959,14 +3959,14 @@ "$id": "355", "Name": "putDefault", "ResourceName": "IntLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "356", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "357", "kind": "constant", @@ -4042,7 +4042,7 @@ "$id": "362", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "363", "kind": "url", @@ -4080,7 +4080,7 @@ "$id": "367", "Name": "getAll", "ResourceName": "FloatLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -4142,7 +4142,7 @@ "$id": "372", "Name": "getDefault", "ResourceName": "FloatLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -4204,14 +4204,14 @@ "$id": "377", "Name": "putAll", "ResourceName": "FloatLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "378", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "379", "kind": "constant", @@ -4281,14 +4281,14 @@ "$id": "383", "Name": "putDefault", "ResourceName": "FloatLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "384", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "385", "kind": "constant", @@ -4364,7 +4364,7 @@ "$id": "390", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "391", "kind": "url", @@ -4402,7 +4402,7 @@ "$id": "395", "Name": "getAll", "ResourceName": "BooleanLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -4464,7 +4464,7 @@ "$id": "400", "Name": "getDefault", "ResourceName": "BooleanLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -4526,14 +4526,14 @@ "$id": "405", "Name": "putAll", "ResourceName": "BooleanLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "406", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "407", "kind": "constant", @@ -4603,14 +4603,14 @@ "$id": "411", "Name": "putDefault", "ResourceName": "BooleanLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "412", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "413", "kind": "constant", @@ -4686,7 +4686,7 @@ "$id": "418", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "419", "kind": "url", @@ -4724,7 +4724,7 @@ "$id": "423", "Name": "getAll", "ResourceName": "UnionStringLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -4786,7 +4786,7 @@ "$id": "428", "Name": "getDefault", "ResourceName": "UnionStringLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -4848,14 +4848,14 @@ "$id": "433", "Name": "putAll", "ResourceName": "UnionStringLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "434", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "435", "kind": "constant", @@ -4925,14 +4925,14 @@ "$id": "439", "Name": "putDefault", "ResourceName": "UnionStringLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "440", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "441", "kind": "constant", @@ -5008,7 +5008,7 @@ "$id": "446", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "447", "kind": "url", @@ -5046,7 +5046,7 @@ "$id": "451", "Name": "getAll", "ResourceName": "UnionIntLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -5108,7 +5108,7 @@ "$id": "456", "Name": "getDefault", "ResourceName": "UnionIntLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -5170,14 +5170,14 @@ "$id": "461", "Name": "putAll", "ResourceName": "UnionIntLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "462", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "463", "kind": "constant", @@ -5247,14 +5247,14 @@ "$id": "467", "Name": "putDefault", "ResourceName": "UnionIntLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "468", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "469", "kind": "constant", @@ -5330,7 +5330,7 @@ "$id": "474", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "475", "kind": "url", @@ -5368,7 +5368,7 @@ "$id": "479", "Name": "getAll", "ResourceName": "UnionFloatLiteral", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -5430,7 +5430,7 @@ "$id": "484", "Name": "getDefault", "ResourceName": "UnionFloatLiteral", - "Description": "Get models that will return the default object", + "Doc": "Get models that will return the default object", "Accessibility": "public", "Parameters": [ { @@ -5492,14 +5492,14 @@ "$id": "489", "Name": "putAll", "ResourceName": "UnionFloatLiteral", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "490", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "491", "kind": "constant", @@ -5569,14 +5569,14 @@ "$id": "495", "Name": "putDefault", "ResourceName": "UnionFloatLiteral", - "Description": "Put a body with default properties.", + "Doc": "Put a body with default properties.", "Accessibility": "public", "Parameters": [ { "$id": "496", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "497", "kind": "constant", @@ -5652,7 +5652,7 @@ "$id": "502", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "503", "kind": "url", @@ -5685,13 +5685,13 @@ { "$id": "506", "Name": "RequiredAndOptional", - "Description": "Test optional and required properties", + "Doc": "Test optional and required properties", "Operations": [ { "$id": "507", "Name": "getAll", "ResourceName": "RequiredAndOptional", - "Description": "Get models that will return all properties in the model", + "Doc": "Get models that will return all properties in the model", "Accessibility": "public", "Parameters": [ { @@ -5753,7 +5753,7 @@ "$id": "512", "Name": "getRequiredOnly", "ResourceName": "RequiredAndOptional", - "Description": "Get models that will return only the required properties", + "Doc": "Get models that will return only the required properties", "Accessibility": "public", "Parameters": [ { @@ -5815,14 +5815,14 @@ "$id": "517", "Name": "putAll", "ResourceName": "RequiredAndOptional", - "Description": "Put a body with all properties present.", + "Doc": "Put a body with all properties present.", "Accessibility": "public", "Parameters": [ { "$id": "518", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "519", "kind": "constant", @@ -5892,14 +5892,14 @@ "$id": "523", "Name": "putRequiredOnly", "ResourceName": "RequiredAndOptional", - "Description": "Put a body with only required properties.", + "Doc": "Put a body with only required properties.", "Accessibility": "public", "Parameters": [ { "$id": "524", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "525", "kind": "constant", @@ -5975,7 +5975,7 @@ "$id": "530", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "531", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/value-types/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/value-types/tspCodeModel.json index cd41538a22..f8b7d62a32 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/value-types/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/property/value-types/tspCodeModel.json @@ -215,7 +215,7 @@ "kind": "enumvalue", "name": "43.125", "value": 43.125, - "description": "43.125", + "doc": "43.125", "valueType": { "$ref": "25" }, @@ -225,7 +225,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The FloatLiteralProperty_property", + "doc": "The FloatLiteralProperty_property", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -248,7 +248,7 @@ "kind": "enumvalue", "name": "42", "value": 42, - "description": "42", + "doc": "42", "valueType": { "$ref": "28" }, @@ -258,7 +258,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The IntLiteralProperty_property", + "doc": "The IntLiteralProperty_property", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -281,7 +281,7 @@ "kind": "enumvalue", "name": "hello", "value": "hello", - "description": "hello", + "doc": "hello", "valueType": { "$ref": "31" }, @@ -291,7 +291,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The StringLiteralProperty_property", + "doc": "The StringLiteralProperty_property", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -325,7 +325,7 @@ "enumType": { "$ref": "33" }, - "description": "First value.", + "doc": "First value.", "decorators": [] }, { @@ -343,11 +343,11 @@ "enumType": { "$ref": "33" }, - "description": "Second value.", + "doc": "Second value.", "decorators": [] } ], - "description": "Enum that will be used as a property for model EnumProperty. Extensible.", + "doc": "Enum that will be used as a property for model EnumProperty. Extensible.", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -381,7 +381,7 @@ "enumType": { "$ref": "39" }, - "description": "First value.", + "doc": "First value.", "decorators": [] }, { @@ -399,11 +399,11 @@ "enumType": { "$ref": "39" }, - "description": "Second value.", + "doc": "Second value.", "decorators": [] } ], - "description": "Enum that will be used as a property for model EnumProperty. Non-extensible.", + "doc": "Enum that will be used as a property for model EnumProperty. Non-extensible.", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -417,7 +417,7 @@ "name": "UnionEnumValueProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnionEnumValueProperty", "usage": "Input,Output,Json", - "description": "Template type for testing models with specific properties. Pass in the type of the property you are looking for", + "doc": "Template type for testing models with specific properties. Pass in the type of the property you are looking for", "decorators": [], "properties": [ { @@ -425,7 +425,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "47", "kind": "constant", @@ -450,7 +450,7 @@ "name": "UnionFloatLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnionFloatLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a union of float literal as property.", + "doc": "Model with a union of float literal as property.", "decorators": [], "properties": [ { @@ -458,7 +458,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "6" }, @@ -477,7 +477,7 @@ "name": "UnionIntLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnionIntLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a union of int literal as property.", + "doc": "Model with a union of int literal as property.", "decorators": [], "properties": [ { @@ -485,7 +485,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "12" }, @@ -504,7 +504,7 @@ "name": "UnionStringLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnionStringLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a union of string literal as property.", + "doc": "Model with a union of string literal as property.", "decorators": [], "properties": [ { @@ -512,7 +512,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "18" }, @@ -531,7 +531,7 @@ "name": "BooleanLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.BooleanLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a boolean literal property.", + "doc": "Model with a boolean literal property.", "decorators": [], "properties": [ { @@ -539,7 +539,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "56", "kind": "constant", @@ -568,7 +568,7 @@ "name": "FloatLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.FloatLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a float literal property.", + "doc": "Model with a float literal property.", "decorators": [], "properties": [ { @@ -576,7 +576,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "60", "kind": "constant", @@ -601,7 +601,7 @@ "name": "IntLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.IntLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a int literal property.", + "doc": "Model with a int literal property.", "decorators": [], "properties": [ { @@ -609,7 +609,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "63", "kind": "constant", @@ -634,7 +634,7 @@ "name": "StringLiteralProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.StringLiteralProperty", "usage": "Input,Output,Json", - "description": "Model with a string literal property.", + "doc": "Model with a string literal property.", "decorators": [], "properties": [ { @@ -642,7 +642,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "66", "kind": "constant", @@ -667,7 +667,7 @@ "name": "UnknownArrayProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnknownArrayProperty", "usage": "Input,Output,Json", - "description": "Model with a property unknown, and the data is an array.", + "doc": "Model with a property unknown, and the data is an array.", "decorators": [], "properties": [ { @@ -675,7 +675,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "69", "kind": "unknown", @@ -698,7 +698,7 @@ "name": "UnknownDictProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnknownDictProperty", "usage": "Input,Output,Json", - "description": "Model with a property unknown, and the data is a dictionnary.", + "doc": "Model with a property unknown, and the data is a dictionnary.", "decorators": [], "properties": [ { @@ -706,7 +706,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "72", "kind": "unknown", @@ -729,7 +729,7 @@ "name": "UnknownIntProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnknownIntProperty", "usage": "Input,Output,Json", - "description": "Model with a property unknown, and the data is a int32.", + "doc": "Model with a property unknown, and the data is a int32.", "decorators": [], "properties": [ { @@ -737,7 +737,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "75", "kind": "unknown", @@ -760,7 +760,7 @@ "name": "UnknownStringProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.UnknownStringProperty", "usage": "Input,Output,Json", - "description": "Model with a property unknown, and the data is a string.", + "doc": "Model with a property unknown, and the data is a string.", "decorators": [], "properties": [ { @@ -768,7 +768,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "78", "kind": "unknown", @@ -791,7 +791,7 @@ "name": "NeverProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.NeverProperty", "usage": "Input,Output,Json", - "description": "Model with a property never. (This property should not be included).", + "doc": "Model with a property never. (This property should not be included).", "decorators": [], "properties": [] }, @@ -801,7 +801,7 @@ "name": "DictionaryStringProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.DictionaryStringProperty", "usage": "Input,Output,Json", - "description": "Model with dictionary string properties", + "doc": "Model with dictionary string properties", "decorators": [], "properties": [ { @@ -809,7 +809,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "82", "kind": "dict", @@ -844,7 +844,7 @@ "name": "CollectionsModelProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.CollectionsModelProperty", "usage": "Input,Output,Json", - "description": "Model with collection model properties", + "doc": "Model with collection model properties", "decorators": [], "properties": [ { @@ -852,7 +852,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "87", "kind": "array", @@ -863,7 +863,7 @@ "name": "InnerModel", "crossLanguageDefinitionId": "Type.Property.ValueTypes.InnerModel", "usage": "Input,Output,Json", - "description": "Inner model. Will be a property type for ModelWithModelProperties", + "doc": "Inner model. Will be a property type for ModelWithModelProperties", "decorators": [], "properties": [ { @@ -871,7 +871,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Required string property", + "doc": "Required string property", "type": { "$id": "90", "kind": "string", @@ -909,7 +909,7 @@ "name": "CollectionsIntProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.CollectionsIntProperty", "usage": "Input,Output,Json", - "description": "Model with collection int properties", + "doc": "Model with collection int properties", "decorators": [], "properties": [ { @@ -917,7 +917,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "93", "kind": "array", @@ -947,7 +947,7 @@ "name": "CollectionsStringProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.CollectionsStringProperty", "usage": "Input,Output,Json", - "description": "Model with collection string properties", + "doc": "Model with collection string properties", "decorators": [], "properties": [ { @@ -955,7 +955,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "97", "kind": "array", @@ -985,7 +985,7 @@ "name": "ModelProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.ModelProperty", "usage": "Input,Output,Json", - "description": "Model with model properties", + "doc": "Model with model properties", "decorators": [], "properties": [ { @@ -993,7 +993,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "88" }, @@ -1012,7 +1012,7 @@ "name": "ExtensibleEnumProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.ExtensibleEnumProperty", "usage": "Input,Output,Json", - "description": "Model with extensible enum properties", + "doc": "Model with extensible enum properties", "decorators": [], "properties": [ { @@ -1020,7 +1020,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "33" }, @@ -1039,7 +1039,7 @@ "name": "EnumProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.EnumProperty", "usage": "Input,Output,Json", - "description": "Model with enum properties", + "doc": "Model with enum properties", "decorators": [], "properties": [ { @@ -1047,7 +1047,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$ref": "39" }, @@ -1066,7 +1066,7 @@ "name": "DurationProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.DurationProperty", "usage": "Input,Output,Json", - "description": "Model with a duration property", + "doc": "Model with a duration property", "decorators": [], "properties": [ { @@ -1074,7 +1074,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "107", "kind": "duration", @@ -1105,7 +1105,7 @@ "name": "DatetimeProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.DatetimeProperty", "usage": "Input,Output,Json", - "description": "Model with a datetime property", + "doc": "Model with a datetime property", "decorators": [], "properties": [ { @@ -1113,7 +1113,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "111", "kind": "utcDateTime", @@ -1144,7 +1144,7 @@ "name": "Decimal128Property", "crossLanguageDefinitionId": "Type.Property.ValueTypes.Decimal128Property", "usage": "Input,Output,Json", - "description": "Model with a decimal128 property", + "doc": "Model with a decimal128 property", "decorators": [], "properties": [ { @@ -1152,7 +1152,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "115", "kind": "decimal128", @@ -1175,7 +1175,7 @@ "name": "DecimalProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.DecimalProperty", "usage": "Input,Output,Json", - "description": "Model with a decimal property", + "doc": "Model with a decimal property", "decorators": [], "properties": [ { @@ -1183,7 +1183,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "118", "kind": "decimal", @@ -1206,7 +1206,7 @@ "name": "FloatProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.FloatProperty", "usage": "Input,Output,Json", - "description": "Model with a float property", + "doc": "Model with a float property", "decorators": [], "properties": [ { @@ -1214,7 +1214,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "121", "kind": "float32", @@ -1237,7 +1237,7 @@ "name": "IntProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.IntProperty", "usage": "Input,Output,Json", - "description": "Model with a int property", + "doc": "Model with a int property", "decorators": [], "properties": [ { @@ -1245,7 +1245,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "124", "kind": "int32", @@ -1268,7 +1268,7 @@ "name": "BytesProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.BytesProperty", "usage": "Input,Output,Json", - "description": "Model with a bytes property", + "doc": "Model with a bytes property", "decorators": [], "properties": [ { @@ -1276,7 +1276,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "127", "kind": "bytes", @@ -1300,7 +1300,7 @@ "name": "StringProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.StringProperty", "usage": "Input,Output,Json", - "description": "Model with a string property", + "doc": "Model with a string property", "decorators": [], "properties": [ { @@ -1308,7 +1308,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "130", "kind": "string", @@ -1331,7 +1331,7 @@ "name": "BooleanProperty", "crossLanguageDefinitionId": "Type.Property.ValueTypes.BooleanProperty", "usage": "Input,Output,Json", - "description": "Model with a boolean property", + "doc": "Model with a boolean property", "decorators": [], "properties": [ { @@ -1339,7 +1339,7 @@ "kind": "property", "name": "property", "serializedName": "property", - "description": "Property", + "doc": "Property", "type": { "$id": "133", "kind": "boolean", @@ -1361,7 +1361,7 @@ { "$id": "134", "Name": "ValueTypesClient", - "Description": "Illustrates various property types for models", + "Doc": "Illustrates various property types for models", "Operations": [], "Protocol": { "$id": "135" @@ -1371,7 +1371,7 @@ "$id": "136", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "137", "kind": "url", @@ -1409,7 +1409,7 @@ "$id": "141", "Name": "get", "ResourceName": "Boolean", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -1471,14 +1471,14 @@ "$id": "146", "Name": "put", "ResourceName": "Boolean", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "147", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "148", "kind": "constant", @@ -1506,7 +1506,7 @@ "$id": "150", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "131" }, @@ -1555,7 +1555,7 @@ "$id": "153", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "154", "kind": "url", @@ -1593,7 +1593,7 @@ "$id": "158", "Name": "get", "ResourceName": "String", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -1655,14 +1655,14 @@ "$id": "163", "Name": "put", "ResourceName": "String", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "164", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "165", "kind": "constant", @@ -1690,7 +1690,7 @@ "$id": "167", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "128" }, @@ -1739,7 +1739,7 @@ "$id": "170", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "171", "kind": "url", @@ -1777,7 +1777,7 @@ "$id": "175", "Name": "get", "ResourceName": "Bytes", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -1839,14 +1839,14 @@ "$id": "180", "Name": "put", "ResourceName": "Bytes", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "181", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "182", "kind": "constant", @@ -1874,7 +1874,7 @@ "$id": "184", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "125" }, @@ -1923,7 +1923,7 @@ "$id": "187", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "188", "kind": "url", @@ -1961,7 +1961,7 @@ "$id": "192", "Name": "get", "ResourceName": "Int", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2023,14 +2023,14 @@ "$id": "197", "Name": "put", "ResourceName": "Int", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "198", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "199", "kind": "constant", @@ -2058,7 +2058,7 @@ "$id": "201", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "122" }, @@ -2107,7 +2107,7 @@ "$id": "204", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "205", "kind": "url", @@ -2145,7 +2145,7 @@ "$id": "209", "Name": "get", "ResourceName": "Float", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2207,14 +2207,14 @@ "$id": "214", "Name": "put", "ResourceName": "Float", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "215", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "216", "kind": "constant", @@ -2242,7 +2242,7 @@ "$id": "218", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "119" }, @@ -2291,7 +2291,7 @@ "$id": "221", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "222", "kind": "url", @@ -2329,7 +2329,7 @@ "$id": "226", "Name": "get", "ResourceName": "Decimal", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2391,14 +2391,14 @@ "$id": "231", "Name": "put", "ResourceName": "Decimal", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "232", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "233", "kind": "constant", @@ -2426,7 +2426,7 @@ "$id": "235", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "116" }, @@ -2475,7 +2475,7 @@ "$id": "238", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "239", "kind": "url", @@ -2513,7 +2513,7 @@ "$id": "243", "Name": "get", "ResourceName": "Decimal128", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2575,14 +2575,14 @@ "$id": "248", "Name": "put", "ResourceName": "Decimal128", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "249", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "250", "kind": "constant", @@ -2610,7 +2610,7 @@ "$id": "252", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "113" }, @@ -2659,7 +2659,7 @@ "$id": "255", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "256", "kind": "url", @@ -2697,7 +2697,7 @@ "$id": "260", "Name": "get", "ResourceName": "Datetime", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2759,14 +2759,14 @@ "$id": "265", "Name": "put", "ResourceName": "Datetime", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "266", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "267", "kind": "constant", @@ -2794,7 +2794,7 @@ "$id": "269", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "109" }, @@ -2843,7 +2843,7 @@ "$id": "272", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "273", "kind": "url", @@ -2881,7 +2881,7 @@ "$id": "277", "Name": "get", "ResourceName": "Duration", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -2943,14 +2943,14 @@ "$id": "282", "Name": "put", "ResourceName": "Duration", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "283", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "284", "kind": "constant", @@ -2978,7 +2978,7 @@ "$id": "286", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "105" }, @@ -3027,7 +3027,7 @@ "$id": "289", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "290", "kind": "url", @@ -3065,7 +3065,7 @@ "$id": "294", "Name": "get", "ResourceName": "Enum", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3127,14 +3127,14 @@ "$id": "299", "Name": "put", "ResourceName": "Enum", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "300", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "301", "kind": "constant", @@ -3162,7 +3162,7 @@ "$id": "303", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "103" }, @@ -3211,7 +3211,7 @@ "$id": "306", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "307", "kind": "url", @@ -3249,7 +3249,7 @@ "$id": "311", "Name": "get", "ResourceName": "ExtensibleEnum", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3311,14 +3311,14 @@ "$id": "316", "Name": "put", "ResourceName": "ExtensibleEnum", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "317", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "318", "kind": "constant", @@ -3346,7 +3346,7 @@ "$id": "320", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "101" }, @@ -3395,7 +3395,7 @@ "$id": "323", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "324", "kind": "url", @@ -3433,7 +3433,7 @@ "$id": "328", "Name": "get", "ResourceName": "Model", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3495,14 +3495,14 @@ "$id": "333", "Name": "put", "ResourceName": "Model", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "334", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "335", "kind": "constant", @@ -3530,7 +3530,7 @@ "$id": "337", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "99" }, @@ -3579,7 +3579,7 @@ "$id": "340", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "341", "kind": "url", @@ -3617,7 +3617,7 @@ "$id": "345", "Name": "get", "ResourceName": "CollectionsString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3679,14 +3679,14 @@ "$id": "350", "Name": "put", "ResourceName": "CollectionsString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "351", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "352", "kind": "constant", @@ -3714,7 +3714,7 @@ "$id": "354", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "95" }, @@ -3763,7 +3763,7 @@ "$id": "357", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "358", "kind": "url", @@ -3801,7 +3801,7 @@ "$id": "362", "Name": "get", "ResourceName": "CollectionsInt", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -3863,14 +3863,14 @@ "$id": "367", "Name": "put", "ResourceName": "CollectionsInt", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "368", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "369", "kind": "constant", @@ -3898,7 +3898,7 @@ "$id": "371", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "91" }, @@ -3947,7 +3947,7 @@ "$id": "374", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "375", "kind": "url", @@ -3985,7 +3985,7 @@ "$id": "379", "Name": "get", "ResourceName": "CollectionsModel", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4047,14 +4047,14 @@ "$id": "384", "Name": "put", "ResourceName": "CollectionsModel", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "385", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "386", "kind": "constant", @@ -4082,7 +4082,7 @@ "$id": "388", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "85" }, @@ -4131,7 +4131,7 @@ "$id": "391", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "392", "kind": "url", @@ -4169,7 +4169,7 @@ "$id": "396", "Name": "get", "ResourceName": "DictionaryString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4231,14 +4231,14 @@ "$id": "401", "Name": "put", "ResourceName": "DictionaryString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "402", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "403", "kind": "constant", @@ -4266,7 +4266,7 @@ "$id": "405", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "80" }, @@ -4315,7 +4315,7 @@ "$id": "408", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "409", "kind": "url", @@ -4353,7 +4353,7 @@ "$id": "413", "Name": "get", "ResourceName": "Never", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4415,14 +4415,14 @@ "$id": "418", "Name": "put", "ResourceName": "Never", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "419", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "420", "kind": "constant", @@ -4450,7 +4450,7 @@ "$id": "422", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "79" }, @@ -4499,7 +4499,7 @@ "$id": "425", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "426", "kind": "url", @@ -4537,7 +4537,7 @@ "$id": "430", "Name": "get", "ResourceName": "UnknownString", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4599,14 +4599,14 @@ "$id": "435", "Name": "put", "ResourceName": "UnknownString", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "436", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "437", "kind": "constant", @@ -4634,7 +4634,7 @@ "$id": "439", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "76" }, @@ -4683,7 +4683,7 @@ "$id": "442", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "443", "kind": "url", @@ -4721,7 +4721,7 @@ "$id": "447", "Name": "get", "ResourceName": "UnknownInt", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4783,14 +4783,14 @@ "$id": "452", "Name": "put", "ResourceName": "UnknownInt", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "453", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "454", "kind": "constant", @@ -4818,7 +4818,7 @@ "$id": "456", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "73" }, @@ -4867,7 +4867,7 @@ "$id": "459", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "460", "kind": "url", @@ -4905,7 +4905,7 @@ "$id": "464", "Name": "get", "ResourceName": "UnknownDict", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -4967,14 +4967,14 @@ "$id": "469", "Name": "put", "ResourceName": "UnknownDict", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "470", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "471", "kind": "constant", @@ -5002,7 +5002,7 @@ "$id": "473", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "70" }, @@ -5051,7 +5051,7 @@ "$id": "476", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "477", "kind": "url", @@ -5089,7 +5089,7 @@ "$id": "481", "Name": "get", "ResourceName": "UnknownArray", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5151,14 +5151,14 @@ "$id": "486", "Name": "put", "ResourceName": "UnknownArray", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "487", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "488", "kind": "constant", @@ -5186,7 +5186,7 @@ "$id": "490", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "67" }, @@ -5235,7 +5235,7 @@ "$id": "493", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "494", "kind": "url", @@ -5273,7 +5273,7 @@ "$id": "498", "Name": "get", "ResourceName": "StringLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5335,14 +5335,14 @@ "$id": "503", "Name": "put", "ResourceName": "StringLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "504", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "505", "kind": "constant", @@ -5370,7 +5370,7 @@ "$id": "507", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "64" }, @@ -5419,7 +5419,7 @@ "$id": "510", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "511", "kind": "url", @@ -5457,7 +5457,7 @@ "$id": "515", "Name": "get", "ResourceName": "IntLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5519,14 +5519,14 @@ "$id": "520", "Name": "put", "ResourceName": "IntLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "521", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "522", "kind": "constant", @@ -5554,7 +5554,7 @@ "$id": "524", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "61" }, @@ -5603,7 +5603,7 @@ "$id": "527", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "528", "kind": "url", @@ -5641,7 +5641,7 @@ "$id": "532", "Name": "get", "ResourceName": "FloatLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5703,14 +5703,14 @@ "$id": "537", "Name": "put", "ResourceName": "FloatLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "538", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "539", "kind": "constant", @@ -5738,7 +5738,7 @@ "$id": "541", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "58" }, @@ -5787,7 +5787,7 @@ "$id": "544", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "545", "kind": "url", @@ -5825,7 +5825,7 @@ "$id": "549", "Name": "get", "ResourceName": "BooleanLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -5887,14 +5887,14 @@ "$id": "554", "Name": "put", "ResourceName": "BooleanLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "555", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "556", "kind": "constant", @@ -5922,7 +5922,7 @@ "$id": "558", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "54" }, @@ -5971,7 +5971,7 @@ "$id": "561", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "562", "kind": "url", @@ -6009,7 +6009,7 @@ "$id": "566", "Name": "get", "ResourceName": "UnionStringLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6071,14 +6071,14 @@ "$id": "571", "Name": "put", "ResourceName": "UnionStringLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "572", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "573", "kind": "constant", @@ -6106,7 +6106,7 @@ "$id": "575", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "52" }, @@ -6155,7 +6155,7 @@ "$id": "578", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "579", "kind": "url", @@ -6193,7 +6193,7 @@ "$id": "583", "Name": "get", "ResourceName": "UnionIntLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6255,14 +6255,14 @@ "$id": "588", "Name": "put", "ResourceName": "UnionIntLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "589", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "590", "kind": "constant", @@ -6290,7 +6290,7 @@ "$id": "592", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "50" }, @@ -6339,7 +6339,7 @@ "$id": "595", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "596", "kind": "url", @@ -6377,7 +6377,7 @@ "$id": "600", "Name": "get", "ResourceName": "UnionFloatLiteral", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6439,14 +6439,14 @@ "$id": "605", "Name": "put", "ResourceName": "UnionFloatLiteral", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "606", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "607", "kind": "constant", @@ -6474,7 +6474,7 @@ "$id": "609", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "48" }, @@ -6523,7 +6523,7 @@ "$id": "612", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "613", "kind": "url", @@ -6561,7 +6561,7 @@ "$id": "617", "Name": "get", "ResourceName": "UnionEnumValue", - "Description": "Get call", + "Doc": "Get call", "Accessibility": "public", "Parameters": [ { @@ -6623,14 +6623,14 @@ "$id": "622", "Name": "put", "ResourceName": "UnionEnumValue", - "Description": "Put operation", + "Doc": "Put operation", "Accessibility": "public", "Parameters": [ { "$id": "623", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "624", "kind": "constant", @@ -6658,7 +6658,7 @@ "$id": "626", "Name": "body", "NameInRequest": "body", - "Description": "body", + "Doc": "body", "Type": { "$ref": "45" }, @@ -6707,7 +6707,7 @@ "$id": "629", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "630", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/scalar/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/scalar/tspCodeModel.json index 84a443b23d..9672651fbc 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/scalar/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/scalar/tspCodeModel.json @@ -17,7 +17,7 @@ "$id": "4", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "5", "kind": "url", @@ -55,7 +55,7 @@ "$id": "9", "Name": "get", "ResourceName": "String", - "Description": "get string value", + "Doc": "get string value", "Accessibility": "public", "Parameters": [ { @@ -121,14 +121,14 @@ "$id": "15", "Name": "put", "ResourceName": "String", - "Description": "put string value", + "Doc": "put string value", "Accessibility": "public", "Parameters": [ { "$id": "16", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "17", "kind": "constant", @@ -156,7 +156,7 @@ "$id": "19", "Name": "body", "NameInRequest": "body", - "Description": "_", + "Doc": "_", "Type": { "$id": "20", "kind": "string", @@ -209,7 +209,7 @@ "$id": "23", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "24", "kind": "url", @@ -247,7 +247,7 @@ "$id": "28", "Name": "get", "ResourceName": "Boolean", - "Description": "get boolean value", + "Doc": "get boolean value", "Accessibility": "public", "Parameters": [ { @@ -313,14 +313,14 @@ "$id": "34", "Name": "put", "ResourceName": "Boolean", - "Description": "put boolean value", + "Doc": "put boolean value", "Accessibility": "public", "Parameters": [ { "$id": "35", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "36", "kind": "constant", @@ -348,7 +348,7 @@ "$id": "38", "Name": "body", "NameInRequest": "body", - "Description": "_", + "Doc": "_", "Type": { "$id": "39", "kind": "boolean", @@ -401,7 +401,7 @@ "$id": "42", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "43", "kind": "url", @@ -439,7 +439,7 @@ "$id": "47", "Name": "get", "ResourceName": "Unknown", - "Description": "get unknown value", + "Doc": "get unknown value", "Accessibility": "public", "Parameters": [ { @@ -505,14 +505,14 @@ "$id": "53", "Name": "put", "ResourceName": "Unknown", - "Description": "put unknown value", + "Doc": "put unknown value", "Accessibility": "public", "Parameters": [ { "$id": "54", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "55", "kind": "constant", @@ -540,7 +540,7 @@ "$id": "57", "Name": "body", "NameInRequest": "body", - "Description": "_", + "Doc": "_", "Type": { "$id": "58", "kind": "unknown", @@ -593,7 +593,7 @@ "$id": "61", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "62", "kind": "url", @@ -626,7 +626,7 @@ { "$id": "65", "Name": "DecimalType", - "Description": "Decimal type", + "Doc": "Decimal type", "Operations": [ { "$id": "66", @@ -703,7 +703,7 @@ "$id": "73", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "74", "kind": "constant", @@ -832,7 +832,7 @@ "$id": "84", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "85", "kind": "url", @@ -865,7 +865,7 @@ { "$id": "88", "Name": "Decimal128Type", - "Description": "Decimal128 type", + "Doc": "Decimal128 type", "Operations": [ { "$id": "89", @@ -942,7 +942,7 @@ "$id": "96", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "97", "kind": "constant", @@ -1071,7 +1071,7 @@ "$id": "107", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "108", "kind": "url", @@ -1104,7 +1104,7 @@ { "$id": "111", "Name": "DecimalVerify", - "Description": "Decimal type verification", + "Doc": "Decimal type verification", "Operations": [ { "$id": "112", @@ -1188,7 +1188,7 @@ "$id": "120", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "121", "kind": "constant", @@ -1268,7 +1268,7 @@ "$id": "127", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "128", "kind": "url", @@ -1301,7 +1301,7 @@ { "$id": "131", "Name": "Decimal128Verify", - "Description": "Decimal128 type verification", + "Doc": "Decimal128 type verification", "Operations": [ { "$id": "132", @@ -1385,7 +1385,7 @@ "$id": "140", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "141", "kind": "constant", @@ -1465,7 +1465,7 @@ "$id": "147", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "148", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/union/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/union/tspCodeModel.json index d2537a386a..00194b0024 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/union/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/type/union/tspCodeModel.json @@ -487,7 +487,7 @@ "kind": "property", "name": "model", "serializedName": "model", - "description": "This should be receive/send the Cat variant", + "doc": "This should be receive/send the Cat variant", "type": { "$id": "58", "kind": "union", @@ -564,7 +564,7 @@ "kind": "property", "name": "literal", "serializedName": "literal", - "description": "This should be receive/send the \"a\" variant", + "doc": "This should be receive/send the \"a\" variant", "type": { "$ref": "58" }, @@ -580,7 +580,7 @@ "kind": "property", "name": "int", "serializedName": "int", - "description": "This should be receive/send the int variant", + "doc": "This should be receive/send the int variant", "type": { "$ref": "58" }, @@ -596,7 +596,7 @@ "kind": "property", "name": "boolean", "serializedName": "boolean", - "description": "This should be receive/send the boolean variant", + "doc": "This should be receive/send the boolean variant", "type": { "$ref": "58" }, @@ -612,7 +612,7 @@ "kind": "property", "name": "array", "serializedName": "array", - "description": "This should be receive/send 4 element with Cat, \"a\", int, and boolean", + "doc": "This should be receive/send 4 element with Cat, \"a\", int, and boolean", "type": { "$id": "70", "kind": "array", @@ -698,7 +698,7 @@ "kind": "property", "name": "stringLiteral", "serializedName": "stringLiteral", - "description": "This should be receive/send the \"a\" variant", + "doc": "This should be receive/send the \"a\" variant", "type": { "$id": "77", "kind": "union", @@ -771,7 +771,7 @@ "kind": "property", "name": "intLiteral", "serializedName": "intLiteral", - "description": "This should be receive/send the 2 variant", + "doc": "This should be receive/send the 2 variant", "type": { "$ref": "77" }, @@ -787,7 +787,7 @@ "kind": "property", "name": "floatLiteral", "serializedName": "floatLiteral", - "description": "This should be receive/send the 3.3 variant", + "doc": "This should be receive/send the 3.3 variant", "type": { "$ref": "77" }, @@ -803,7 +803,7 @@ "kind": "property", "name": "booleanLiteral", "serializedName": "booleanLiteral", - "description": "This should be receive/send the true variant", + "doc": "This should be receive/send the true variant", "type": { "$ref": "77" }, @@ -879,7 +879,7 @@ "kind": "property", "name": "string", "serializedName": "string", - "description": "This should be receive/send the string variant", + "doc": "This should be receive/send the string variant", "type": { "$id": "95", "kind": "union", @@ -921,7 +921,7 @@ "kind": "property", "name": "array", "serializedName": "array", - "description": "This should be receive/send the array variant", + "doc": "This should be receive/send the array variant", "type": { "$id": "100", "kind": "union", @@ -1023,7 +1023,7 @@ "kind": "property", "name": "lr", "serializedName": "lr", - "description": "This should be receive/send the left variant", + "doc": "This should be receive/send the left variant", "type": { "$ref": "2" }, @@ -1039,7 +1039,7 @@ "kind": "property", "name": "ud", "serializedName": "ud", - "description": "This should be receive/send the up variant", + "doc": "This should be receive/send the up variant", "type": { "$ref": "12" }, @@ -1434,7 +1434,7 @@ { "$id": "141", "Name": "UnionClient", - "Description": "Describe scenarios for various combinations of unions.", + "Doc": "Describe scenarios for various combinations of unions.", "Operations": [], "Protocol": { "$id": "142" @@ -1444,7 +1444,7 @@ "$id": "143", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "144", "kind": "url", @@ -1477,7 +1477,7 @@ { "$id": "147", "Name": "StringsOnly", - "Description": "Describe union of string \"a\" | \"b\" | \"c\"", + "Doc": "Describe union of string \"a\" | \"b\" | \"c\"", "Operations": [ { "$id": "148", @@ -1550,7 +1550,7 @@ "$id": "154", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "155", "kind": "constant", @@ -1626,7 +1626,7 @@ "$id": "160", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "161", "kind": "url", @@ -1659,7 +1659,7 @@ { "$id": "164", "Name": "StringExtensible", - "Description": "Describe union of string string | \"b\" | \"c\"", + "Doc": "Describe union of string string | \"b\" | \"c\"", "Operations": [ { "$id": "165", @@ -1732,7 +1732,7 @@ "$id": "171", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "172", "kind": "constant", @@ -1808,7 +1808,7 @@ "$id": "177", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "178", "kind": "url", @@ -1841,7 +1841,7 @@ { "$id": "181", "Name": "StringExtensibleNamed", - "Description": "Describe union of string string | \"b\" | \"c\" but where the union is named and some of the variants are named", + "Doc": "Describe union of string string | \"b\" | \"c\" but where the union is named and some of the variants are named", "Operations": [ { "$id": "182", @@ -1914,7 +1914,7 @@ "$id": "188", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "189", "kind": "constant", @@ -1990,7 +1990,7 @@ "$id": "194", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "195", "kind": "url", @@ -2023,7 +2023,7 @@ { "$id": "198", "Name": "IntsOnly", - "Description": "Describe union of integer 1 | 2 | 3", + "Doc": "Describe union of integer 1 | 2 | 3", "Operations": [ { "$id": "199", @@ -2096,7 +2096,7 @@ "$id": "205", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "206", "kind": "constant", @@ -2172,7 +2172,7 @@ "$id": "211", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "212", "kind": "url", @@ -2205,7 +2205,7 @@ { "$id": "215", "Name": "FloatsOnly", - "Description": "Describe union of floats 1.1 | 2.2 | 3.3", + "Doc": "Describe union of floats 1.1 | 2.2 | 3.3", "Operations": [ { "$id": "216", @@ -2278,7 +2278,7 @@ "$id": "222", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "223", "kind": "constant", @@ -2354,7 +2354,7 @@ "$id": "228", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "229", "kind": "url", @@ -2387,7 +2387,7 @@ { "$id": "232", "Name": "ModelsOnly", - "Description": "Describe union of models", + "Doc": "Describe union of models", "Operations": [ { "$id": "233", @@ -2460,7 +2460,7 @@ "$id": "239", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "240", "kind": "constant", @@ -2536,7 +2536,7 @@ "$id": "245", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "246", "kind": "url", @@ -2569,7 +2569,7 @@ { "$id": "249", "Name": "EnumsOnly", - "Description": "Describe union of 2 different enums", + "Doc": "Describe union of 2 different enums", "Operations": [ { "$id": "250", @@ -2642,7 +2642,7 @@ "$id": "256", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "257", "kind": "constant", @@ -2718,7 +2718,7 @@ "$id": "262", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "263", "kind": "url", @@ -2751,7 +2751,7 @@ { "$id": "266", "Name": "StringAndArray", - "Description": "Describe union of a string and an array of strings", + "Doc": "Describe union of a string and an array of strings", "Operations": [ { "$id": "267", @@ -2824,7 +2824,7 @@ "$id": "273", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "274", "kind": "constant", @@ -2900,7 +2900,7 @@ "$id": "279", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "280", "kind": "url", @@ -2933,7 +2933,7 @@ { "$id": "283", "Name": "MixedLiterals", - "Description": "Describe union of floats \"a\" | 2 | 3.3", + "Doc": "Describe union of floats \"a\" | 2 | 3.3", "Operations": [ { "$id": "284", @@ -3006,7 +3006,7 @@ "$id": "290", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "291", "kind": "constant", @@ -3082,7 +3082,7 @@ "$id": "296", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "297", "kind": "url", @@ -3115,7 +3115,7 @@ { "$id": "300", "Name": "MixedTypes", - "Description": "Describe union of floats \"a\" | 2 | 3.3", + "Doc": "Describe union of floats \"a\" | 2 | 3.3", "Operations": [ { "$id": "301", @@ -3188,7 +3188,7 @@ "$id": "307", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "308", "kind": "constant", @@ -3264,7 +3264,7 @@ "$id": "313", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Service host", + "Doc": "Service host", "Type": { "$id": "314", "kind": "url", diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v1/tspCodeModel.json index f973fbb958..be11956d49 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v1/tspCodeModel.json @@ -69,11 +69,11 @@ "enumType": { "$ref": "6" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -130,7 +130,7 @@ { "$id": "14", "Name": "AddedClient", - "Description": "Test for the `@added` decorator.", + "Doc": "Test for the `@added` decorator.", "Operations": [ { "$id": "15", @@ -142,7 +142,7 @@ "$id": "16", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "17", "kind": "constant", @@ -250,7 +250,7 @@ "$id": "25", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "26", "kind": "url", @@ -271,7 +271,7 @@ "$id": "27", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "6" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v2/tspCodeModel.json index b97fdf50a0..ba760d0ccf 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/added/v2/tspCodeModel.json @@ -123,7 +123,7 @@ "enumType": { "$ref": "12" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] }, { @@ -141,11 +141,11 @@ "enumType": { "$ref": "12" }, - "description": "The version v2.", + "doc": "The version v2.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -321,7 +321,7 @@ { "$id": "35", "Name": "AddedClient", - "Description": "Test for the `@added` decorator.", + "Doc": "Test for the `@added` decorator.", "Operations": [ { "$id": "36", @@ -354,7 +354,7 @@ "$id": "39", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "40", "kind": "constant", @@ -463,7 +463,7 @@ "$id": "48", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "49", "kind": "constant", @@ -571,7 +571,7 @@ "$id": "57", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "58", "kind": "url", @@ -592,7 +592,7 @@ "$id": "59", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "12" }, @@ -623,7 +623,7 @@ "$id": "62", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "63", "kind": "constant", @@ -732,7 +732,7 @@ "$id": "71", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "72", "kind": "url", @@ -753,7 +753,7 @@ "$id": "73", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "12" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v1/tspCodeModel.json index 1a5ce90ce9..39b9405121 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v1/tspCodeModel.json @@ -33,11 +33,11 @@ "enumType": { "$ref": "2" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -98,7 +98,7 @@ { "$id": "11", "Name": "MadeOptionalClient", - "Description": "Test for the `@madeOptional` decorator.", + "Doc": "Test for the `@madeOptional` decorator.", "Operations": [ { "$id": "12", @@ -131,7 +131,7 @@ "$id": "15", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "16", "kind": "constant", @@ -239,7 +239,7 @@ "$id": "24", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "25", "kind": "url", @@ -260,7 +260,7 @@ "$id": "26", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v2/tspCodeModel.json index 90207ea958..507d20ed59 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/madeOptional/v2/tspCodeModel.json @@ -34,7 +34,7 @@ "enumType": { "$ref": "2" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] }, { @@ -52,11 +52,11 @@ "enumType": { "$ref": "2" }, - "description": "The version v2.", + "doc": "The version v2.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -117,7 +117,7 @@ { "$id": "13", "Name": "MadeOptionalClient", - "Description": "Test for the `@madeOptional` decorator.", + "Doc": "Test for the `@madeOptional` decorator.", "Operations": [ { "$id": "14", @@ -150,7 +150,7 @@ "$id": "17", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "18", "kind": "constant", @@ -258,7 +258,7 @@ "$id": "26", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "27", "kind": "url", @@ -279,7 +279,7 @@ "$id": "28", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v1/tspCodeModel.json index 3f046e33d4..0ed88aa761 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v1/tspCodeModel.json @@ -175,11 +175,11 @@ "enumType": { "$ref": "18" }, - "description": "The original version v1.", + "doc": "The original version v1.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -425,20 +425,20 @@ { "$id": "46", "Name": "RemovedClient", - "Description": "Test for the `@removed` decorator.", + "Doc": "Test for the `@removed` decorator.", "Operations": [ { "$id": "47", "Name": "v1", "ResourceName": "Removed", - "Description": "This operation should not be generated with latest version's signature.", + "Doc": "This operation should not be generated with latest version's signature.", "Accessibility": "public", "Parameters": [ { "$id": "48", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "49", "kind": "constant", @@ -568,7 +568,7 @@ "$id": "59", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "60", "kind": "constant", @@ -671,14 +671,14 @@ "$id": "67", "Name": "modelV3", "ResourceName": "Removed", - "Description": "This operation will pass different paths and different request bodies based on different versions.", + "Doc": "This operation will pass different paths and different request bodies based on different versions.", "Accessibility": "public", "Parameters": [ { "$id": "68", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "69", "kind": "constant", @@ -786,7 +786,7 @@ "$id": "77", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "78", "kind": "url", @@ -807,7 +807,7 @@ "$id": "79", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", + "Doc": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", "Type": { "$ref": "18" }, @@ -827,7 +827,7 @@ { "$id": "80", "Name": "InterfaceV1", - "Description": "This operation group should not be generated with latest version.", + "Doc": "This operation group should not be generated with latest version.", "Operations": [ { "$id": "81", @@ -839,7 +839,7 @@ "$id": "82", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "83", "kind": "constant", @@ -948,7 +948,7 @@ "$id": "91", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "92", "kind": "url", @@ -969,7 +969,7 @@ "$id": "93", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", + "Doc": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", "Type": { "$ref": "18" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2/tspCodeModel.json index bd20f18e41..b2c5f77339 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2/tspCodeModel.json @@ -124,7 +124,7 @@ "enumType": { "$ref": "12" }, - "description": "The original version v1.", + "doc": "The original version v1.", "decorators": [] }, { @@ -142,7 +142,7 @@ "enumType": { "$ref": "12" }, - "description": "The V2 Preview version.", + "doc": "The V2 Preview version.", "decorators": [] }, { @@ -160,11 +160,11 @@ "enumType": { "$ref": "12" }, - "description": "The latest version v2.", + "doc": "The latest version v2.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -299,7 +299,7 @@ { "$id": "32", "Name": "RemovedClient", - "Description": "Test for the `@removed` decorator.", + "Doc": "Test for the `@removed` decorator.", "Operations": [ { "$id": "33", @@ -311,7 +311,7 @@ "$id": "34", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "35", "kind": "constant", @@ -414,14 +414,14 @@ "$id": "42", "Name": "modelV3", "ResourceName": "Removed", - "Description": "This operation will pass different paths and different request bodies based on different versions.", + "Doc": "This operation will pass different paths and different request bodies based on different versions.", "Accessibility": "public", "Parameters": [ { "$id": "43", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "44", "kind": "constant", @@ -529,7 +529,7 @@ "$id": "52", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "53", "kind": "url", @@ -550,7 +550,7 @@ "$id": "54", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", + "Doc": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", "Type": { "$ref": "12" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2Preview/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2Preview/tspCodeModel.json index 2a9efd0fd9..94c33a8b93 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2Preview/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/removed/v2Preview/tspCodeModel.json @@ -123,7 +123,7 @@ "enumType": { "$ref": "12" }, - "description": "The original version v1.", + "doc": "The original version v1.", "decorators": [] }, { @@ -141,11 +141,11 @@ "enumType": { "$ref": "12" }, - "description": "The V2 Preview version.", + "doc": "The V2 Preview version.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -376,20 +376,20 @@ { "$id": "41", "Name": "RemovedClient", - "Description": "Test for the `@removed` decorator.", + "Doc": "Test for the `@removed` decorator.", "Operations": [ { "$id": "42", "Name": "v1", "ResourceName": "Removed", - "Description": "This operation should not be generated with latest version's signature.", + "Doc": "This operation should not be generated with latest version's signature.", "Accessibility": "public", "Parameters": [ { "$id": "43", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "44", "kind": "constant", @@ -519,7 +519,7 @@ "$id": "54", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "55", "kind": "constant", @@ -622,14 +622,14 @@ "$id": "62", "Name": "modelV3", "ResourceName": "Removed", - "Description": "This operation will pass different paths and different request bodies based on different versions.", + "Doc": "This operation will pass different paths and different request bodies based on different versions.", "Accessibility": "public", "Parameters": [ { "$id": "63", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "64", "kind": "constant", @@ -737,7 +737,7 @@ "$id": "72", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "73", "kind": "url", @@ -758,7 +758,7 @@ "$id": "74", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", + "Doc": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", "Type": { "$ref": "12" }, @@ -778,7 +778,7 @@ { "$id": "75", "Name": "InterfaceV1", - "Description": "This operation group should not be generated with latest version.", + "Doc": "This operation group should not be generated with latest version.", "Operations": [ { "$id": "76", @@ -790,7 +790,7 @@ "$id": "77", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "78", "kind": "constant", @@ -899,7 +899,7 @@ "$id": "86", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "87", "kind": "url", @@ -920,7 +920,7 @@ "$id": "88", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", + "Doc": "Need to be set as 'v1', 'v2preview' or 'v2' in client.", "Type": { "$ref": "12" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v1/tspCodeModel.json index e9411d9300..d4ed27d954 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v1/tspCodeModel.json @@ -69,11 +69,11 @@ "enumType": { "$ref": "6" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -171,7 +171,7 @@ { "$id": "19", "Name": "RenamedFromClient", - "Description": "Test for the `@renamedFrom` decorator.", + "Doc": "Test for the `@renamedFrom` decorator.", "Operations": [ { "$id": "20", @@ -204,7 +204,7 @@ "$id": "23", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "24", "kind": "constant", @@ -312,7 +312,7 @@ "$id": "32", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "33", "kind": "url", @@ -333,7 +333,7 @@ "$id": "34", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "6" }, @@ -364,7 +364,7 @@ "$id": "37", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "38", "kind": "constant", @@ -473,7 +473,7 @@ "$id": "46", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "47", "kind": "url", @@ -494,7 +494,7 @@ "$id": "48", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "6" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v2/tspCodeModel.json index 95d7023057..835e4b2823 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/renamedFrom/v2/tspCodeModel.json @@ -70,7 +70,7 @@ "enumType": { "$ref": "6" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] }, { @@ -88,11 +88,11 @@ "enumType": { "$ref": "6" }, - "description": "The version v2.", + "doc": "The version v2.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -190,7 +190,7 @@ { "$id": "21", "Name": "RenamedFromClient", - "Description": "Test for the `@renamedFrom` decorator.", + "Doc": "Test for the `@renamedFrom` decorator.", "Operations": [ { "$id": "22", @@ -223,7 +223,7 @@ "$id": "25", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "26", "kind": "constant", @@ -331,7 +331,7 @@ "$id": "34", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "35", "kind": "url", @@ -352,7 +352,7 @@ "$id": "36", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "6" }, @@ -383,7 +383,7 @@ "$id": "39", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "40", "kind": "constant", @@ -492,7 +492,7 @@ "$id": "48", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "49", "kind": "url", @@ -513,7 +513,7 @@ "$id": "50", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "6" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v1/tspCodeModel.json index 61dcea416a..4e0e15a35b 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v1/tspCodeModel.json @@ -33,11 +33,11 @@ "enumType": { "$ref": "2" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -49,7 +49,7 @@ { "$id": "6", "Name": "ReturnTypeChangedFromClient", - "Description": "Test for the `@returnTypeChangedFrom` decorator.", + "Doc": "Test for the `@returnTypeChangedFrom` decorator.", "Operations": [ { "$id": "7", @@ -61,7 +61,7 @@ "$id": "8", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "9", "kind": "constant", @@ -177,7 +177,7 @@ "$id": "19", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "20", "kind": "url", @@ -198,7 +198,7 @@ "$id": "21", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v2/tspCodeModel.json index 4e307e361d..7202d682cd 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/returnTypeChangedFrom/v2/tspCodeModel.json @@ -34,7 +34,7 @@ "enumType": { "$ref": "2" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] }, { @@ -52,11 +52,11 @@ "enumType": { "$ref": "2" }, - "description": "The version v2.", + "doc": "The version v2.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -68,7 +68,7 @@ { "$id": "8", "Name": "ReturnTypeChangedFromClient", - "Description": "Test for the `@returnTypeChangedFrom` decorator.", + "Doc": "Test for the `@returnTypeChangedFrom` decorator.", "Operations": [ { "$id": "9", @@ -80,7 +80,7 @@ "$id": "10", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "11", "kind": "constant", @@ -196,7 +196,7 @@ "$id": "21", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "22", "kind": "url", @@ -217,7 +217,7 @@ "$id": "23", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v1/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v1/tspCodeModel.json index d127fe74bf..1af3d4380d 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v1/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v1/tspCodeModel.json @@ -33,11 +33,11 @@ "enumType": { "$ref": "2" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -98,7 +98,7 @@ { "$id": "11", "Name": "TypeChangedFromClient", - "Description": "Test for the `@typeChangedFrom` decorator.", + "Doc": "Test for the `@typeChangedFrom` decorator.", "Operations": [ { "$id": "12", @@ -131,7 +131,7 @@ "$id": "15", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "16", "kind": "constant", @@ -239,7 +239,7 @@ "$id": "24", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "25", "kind": "url", @@ -260,7 +260,7 @@ "$id": "26", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v2/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v2/tspCodeModel.json index 710a591393..4211c92207 100644 --- a/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v2/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/CadlRanch/http/versioning/typeChangedFrom/v2/tspCodeModel.json @@ -34,7 +34,7 @@ "enumType": { "$ref": "2" }, - "description": "The version v1.", + "doc": "The version v1.", "decorators": [] }, { @@ -52,11 +52,11 @@ "enumType": { "$ref": "2" }, - "description": "The version v2.", + "doc": "The version v2.", "decorators": [] } ], - "description": "The version of the API.", + "doc": "The version of the API.", "isFixed": true, "isFlags": false, "usage": "Input,ApiVersionEnum", @@ -117,7 +117,7 @@ { "$id": "13", "Name": "TypeChangedFromClient", - "Description": "Test for the `@typeChangedFrom` decorator.", + "Doc": "Test for the `@typeChangedFrom` decorator.", "Operations": [ { "$id": "14", @@ -150,7 +150,7 @@ "$id": "17", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "18", "kind": "constant", @@ -258,7 +258,7 @@ "$id": "26", "Name": "endpoint", "NameInRequest": "endpoint", - "Description": "Need to be set as 'http://localhost:3000' in client.", + "Doc": "Need to be set as 'http://localhost:3000' in client.", "Type": { "$id": "27", "kind": "url", @@ -279,7 +279,7 @@ "$id": "28", "Name": "version", "NameInRequest": "version", - "Description": "Need to be set as 'v1' or 'v2' in client.", + "Doc": "Need to be set as 'v1' or 'v2' in client.", "Type": { "$ref": "2" }, diff --git a/packages/http-client-csharp/generator/TestProjects/Local/Unbranded-TypeSpec/tspCodeModel.json b/packages/http-client-csharp/generator/TestProjects/Local/Unbranded-TypeSpec/tspCodeModel.json index 60ed133f07..4633b09745 100644 --- a/packages/http-client-csharp/generator/TestProjects/Local/Unbranded-TypeSpec/tspCodeModel.json +++ b/packages/http-client-csharp/generator/TestProjects/Local/Unbranded-TypeSpec/tspCodeModel.json @@ -23,7 +23,7 @@ "kind": "enumvalue", "name": "accept", "value": "accept", - "description": "accept", + "doc": "accept", "valueType": { "$ref": "3" }, @@ -33,7 +33,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The Thing_requiredLiteralString", + "doc": "The Thing_requiredLiteralString", "isFixed": false, "isFlags": false, "usage": "Input,Output,Spread,Json", @@ -56,7 +56,7 @@ "kind": "enumvalue", "name": "123", "value": 123, - "description": "123", + "doc": "123", "valueType": { "$ref": "6" }, @@ -66,7 +66,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The Thing_requiredLiteralInt", + "doc": "The Thing_requiredLiteralInt", "isFixed": false, "isFlags": false, "usage": "Input,Output,Spread,Json", @@ -89,7 +89,7 @@ "kind": "enumvalue", "name": "1.23", "value": 1.23, - "description": "1.23", + "doc": "1.23", "valueType": { "$ref": "9" }, @@ -99,7 +99,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The Thing_requiredLiteralFloat", + "doc": "The Thing_requiredLiteralFloat", "isFixed": false, "isFlags": false, "usage": "Input,Output,Spread,Json", @@ -122,7 +122,7 @@ "kind": "enumvalue", "name": "reject", "value": "reject", - "description": "reject", + "doc": "reject", "valueType": { "$ref": "12" }, @@ -132,7 +132,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The Thing_optionalLiteralString", + "doc": "The Thing_optionalLiteralString", "isFixed": false, "isFlags": false, "usage": "Input,Output,Spread,Json", @@ -155,7 +155,7 @@ "kind": "enumvalue", "name": "456", "value": 456, - "description": "456", + "doc": "456", "valueType": { "$ref": "15" }, @@ -165,7 +165,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The Thing_optionalLiteralInt", + "doc": "The Thing_optionalLiteralInt", "isFixed": false, "isFlags": false, "usage": "Input,Output,Spread,Json", @@ -188,7 +188,7 @@ "kind": "enumvalue", "name": "4.56", "value": 4.56, - "description": "4.56", + "doc": "4.56", "valueType": { "$ref": "18" }, @@ -198,7 +198,7 @@ } ], "crossLanguageDefinitionId": "", - "description": "The Thing_optionalLiteralFloat", + "doc": "The Thing_optionalLiteralFloat", "isFixed": false, "isFlags": false, "usage": "Input,Output,Spread,Json", @@ -269,7 +269,7 @@ "decorators": [] } ], - "description": "Simple enum", + "doc": "Simple enum", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -340,7 +340,7 @@ "decorators": [] } ], - "description": "Extensible enum", + "doc": "Extensible enum", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -411,7 +411,7 @@ "decorators": [] } ], - "description": "Int based extensible enum", + "doc": "Int based extensible enum", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -482,7 +482,7 @@ "decorators": [] } ], - "description": "Float based extensible enum", + "doc": "Float based extensible enum", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -553,7 +553,7 @@ "decorators": [] } ], - "description": "float fixed enum", + "doc": "float fixed enum", "isFixed": false, "isFlags": false, "usage": "Input,Output,Json", @@ -624,7 +624,7 @@ "decorators": [] } ], - "description": "float fixed enum", + "doc": "float fixed enum", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -695,7 +695,7 @@ "decorators": [] } ], - "description": "float fixed enum", + "doc": "float fixed enum", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -766,7 +766,7 @@ "decorators": [] } ], - "description": "int fixed enum", + "doc": "int fixed enum", "isFixed": true, "isFlags": false, "usage": "Input,Output,Json", @@ -833,7 +833,7 @@ "name": "Thing", "crossLanguageDefinitionId": "UnbrandedTypeSpec.Thing", "usage": "Input,Output,Spread,Json", - "description": "A model with a few properties of literal types", + "doc": "A model with a few properties of literal types", "decorators": [], "properties": [ { @@ -841,7 +841,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "name of the Thing", + "doc": "name of the Thing", "type": { "$id": "92", "kind": "string", @@ -861,7 +861,7 @@ "kind": "property", "name": "requiredUnion", "serializedName": "requiredUnion", - "description": "required Union", + "doc": "required Union", "type": { "$id": "94", "kind": "union", @@ -910,7 +910,7 @@ "kind": "property", "name": "requiredLiteralString", "serializedName": "requiredLiteralString", - "description": "required literal string", + "doc": "required literal string", "type": { "$id": "100", "kind": "constant", @@ -932,7 +932,7 @@ "kind": "property", "name": "requiredLiteralInt", "serializedName": "requiredLiteralInt", - "description": "required literal int", + "doc": "required literal int", "type": { "$id": "102", "kind": "constant", @@ -954,7 +954,7 @@ "kind": "property", "name": "requiredLiteralFloat", "serializedName": "requiredLiteralFloat", - "description": "required literal float", + "doc": "required literal float", "type": { "$id": "104", "kind": "constant", @@ -976,7 +976,7 @@ "kind": "property", "name": "requiredLiteralBool", "serializedName": "requiredLiteralBool", - "description": "required literal bool", + "doc": "required literal bool", "type": { "$id": "106", "kind": "constant", @@ -1002,7 +1002,7 @@ "kind": "property", "name": "optionalLiteralString", "serializedName": "optionalLiteralString", - "description": "optional literal string", + "doc": "optional literal string", "type": { "$id": "109", "kind": "constant", @@ -1024,7 +1024,7 @@ "kind": "property", "name": "optionalLiteralInt", "serializedName": "optionalLiteralInt", - "description": "optional literal int", + "doc": "optional literal int", "type": { "$id": "111", "kind": "constant", @@ -1046,7 +1046,7 @@ "kind": "property", "name": "optionalLiteralFloat", "serializedName": "optionalLiteralFloat", - "description": "optional literal float", + "doc": "optional literal float", "type": { "$id": "113", "kind": "constant", @@ -1068,7 +1068,7 @@ "kind": "property", "name": "optionalLiteralBool", "serializedName": "optionalLiteralBool", - "description": "optional literal bool", + "doc": "optional literal bool", "type": { "$id": "115", "kind": "constant", @@ -1094,7 +1094,7 @@ "kind": "property", "name": "requiredBadDescription", "serializedName": "requiredBadDescription", - "description": "description with xml <|endoftext|>", + "doc": "description with xml <|endoftext|>", "type": { "$id": "118", "kind": "string", @@ -1114,7 +1114,7 @@ "kind": "property", "name": "optionalNullableList", "serializedName": "optionalNullableList", - "description": "optional nullable collection", + "doc": "optional nullable collection", "type": { "$id": "120", "kind": "nullable", @@ -1145,7 +1145,7 @@ "kind": "property", "name": "requiredNullableList", "serializedName": "requiredNullableList", - "description": "required nullable collection", + "doc": "required nullable collection", "type": { "$id": "124", "kind": "nullable", @@ -1179,7 +1179,7 @@ "name": "RoundTripModel", "crossLanguageDefinitionId": "UnbrandedTypeSpec.RoundTripModel", "usage": "Input,Output,Json", - "description": "this is a roundtrip model", + "doc": "this is a roundtrip model", "decorators": [], "properties": [ { @@ -1187,7 +1187,7 @@ "kind": "property", "name": "requiredString", "serializedName": "requiredString", - "description": "Required string, illustrating a reference type property.", + "doc": "Required string, illustrating a reference type property.", "type": { "$id": "129", "kind": "string", @@ -1207,7 +1207,7 @@ "kind": "property", "name": "requiredInt", "serializedName": "requiredInt", - "description": "Required int, illustrating a value type property.", + "doc": "Required int, illustrating a value type property.", "type": { "$id": "131", "kind": "int32", @@ -1228,7 +1228,7 @@ "kind": "property", "name": "requiredCollection", "serializedName": "requiredCollection", - "description": "Required collection of enums", + "doc": "Required collection of enums", "type": { "$id": "133", "kind": "array", @@ -1251,7 +1251,7 @@ "kind": "property", "name": "requiredDictionary", "serializedName": "requiredDictionary", - "description": "Required dictionary of enums", + "doc": "Required dictionary of enums", "type": { "$id": "135", "kind": "dict", @@ -1279,7 +1279,7 @@ "kind": "property", "name": "requiredModel", "serializedName": "requiredModel", - "description": "Required model", + "doc": "Required model", "type": { "$ref": "90" }, @@ -1295,7 +1295,7 @@ "kind": "property", "name": "intExtensibleEnum", "serializedName": "intExtensibleEnum", - "description": "this is an int based extensible enum", + "doc": "this is an int based extensible enum", "type": { "$ref": "36" }, @@ -1311,7 +1311,7 @@ "kind": "property", "name": "intExtensibleEnumCollection", "serializedName": "intExtensibleEnumCollection", - "description": "this is a collection of int based extensible enum", + "doc": "this is a collection of int based extensible enum", "type": { "$id": "140", "kind": "array", @@ -1334,7 +1334,7 @@ "kind": "property", "name": "floatExtensibleEnum", "serializedName": "floatExtensibleEnum", - "description": "this is a float based extensible enum", + "doc": "this is a float based extensible enum", "type": { "$ref": "44" }, @@ -1350,7 +1350,7 @@ "kind": "property", "name": "floatExtensibleEnumWithIntValue", "serializedName": "floatExtensibleEnumWithIntValue", - "description": "this is a float based extensible enum", + "doc": "this is a float based extensible enum", "type": { "$ref": "52" }, @@ -1366,7 +1366,7 @@ "kind": "property", "name": "floatExtensibleEnumCollection", "serializedName": "floatExtensibleEnumCollection", - "description": "this is a collection of float based extensible enum", + "doc": "this is a collection of float based extensible enum", "type": { "$id": "144", "kind": "array", @@ -1389,7 +1389,7 @@ "kind": "property", "name": "floatFixedEnum", "serializedName": "floatFixedEnum", - "description": "this is a float based fixed enum", + "doc": "this is a float based fixed enum", "type": { "$ref": "60" }, @@ -1405,7 +1405,7 @@ "kind": "property", "name": "floatFixedEnumWithIntValue", "serializedName": "floatFixedEnumWithIntValue", - "description": "this is a float based fixed enum", + "doc": "this is a float based fixed enum", "type": { "$ref": "68" }, @@ -1421,7 +1421,7 @@ "kind": "property", "name": "floatFixedEnumCollection", "serializedName": "floatFixedEnumCollection", - "description": "this is a collection of float based fixed enum", + "doc": "this is a collection of float based fixed enum", "type": { "$id": "148", "kind": "array", @@ -1444,7 +1444,7 @@ "kind": "property", "name": "intFixedEnum", "serializedName": "intFixedEnum", - "description": "this is a int based fixed enum", + "doc": "this is a int based fixed enum", "type": { "$ref": "76" }, @@ -1460,7 +1460,7 @@ "kind": "property", "name": "intFixedEnumCollection", "serializedName": "intFixedEnumCollection", - "description": "this is a collection of int based fixed enum", + "doc": "this is a collection of int based fixed enum", "type": { "$id": "151", "kind": "array", @@ -1483,7 +1483,7 @@ "kind": "property", "name": "stringFixedEnum", "serializedName": "stringFixedEnum", - "description": "this is a string based fixed enum", + "doc": "this is a string based fixed enum", "type": { "$ref": "20" }, @@ -1499,7 +1499,7 @@ "kind": "property", "name": "requiredUnknown", "serializedName": "requiredUnknown", - "description": "required unknown", + "doc": "required unknown", "type": { "$id": "154", "kind": "unknown", @@ -1519,7 +1519,7 @@ "kind": "property", "name": "optionalUnknown", "serializedName": "optionalUnknown", - "description": "optional unknown", + "doc": "optional unknown", "type": { "$id": "156", "kind": "unknown", @@ -1539,7 +1539,7 @@ "kind": "property", "name": "requiredRecordUnknown", "serializedName": "requiredRecordUnknown", - "description": "required record of unknown", + "doc": "required record of unknown", "type": { "$id": "158", "kind": "dict", @@ -1571,7 +1571,7 @@ "kind": "property", "name": "optionalRecordUnknown", "serializedName": "optionalRecordUnknown", - "description": "optional record of unknown", + "doc": "optional record of unknown", "type": { "$id": "162", "kind": "dict", @@ -1603,7 +1603,7 @@ "kind": "property", "name": "readOnlyRequiredRecordUnknown", "serializedName": "readOnlyRequiredRecordUnknown", - "description": "required readonly record of unknown", + "doc": "required readonly record of unknown", "type": { "$id": "166", "kind": "dict", @@ -1635,7 +1635,7 @@ "kind": "property", "name": "readOnlyOptionalRecordUnknown", "serializedName": "readOnlyOptionalRecordUnknown", - "description": "optional readonly record of unknown", + "doc": "optional readonly record of unknown", "type": { "$id": "170", "kind": "dict", @@ -1667,14 +1667,14 @@ "kind": "property", "name": "modelWithRequiredNullable", "serializedName": "modelWithRequiredNullable", - "description": "this is a model with required nullable properties", + "doc": "this is a model with required nullable properties", "type": { "$id": "174", "kind": "model", "name": "ModelWithRequiredNullableProperties", "crossLanguageDefinitionId": "UnbrandedTypeSpec.ModelWithRequiredNullableProperties", "usage": "Input,Output,Json", - "description": "A model with a few required nullable properties", + "doc": "A model with a few required nullable properties", "decorators": [], "properties": [ { @@ -1682,7 +1682,7 @@ "kind": "property", "name": "requiredNullablePrimitive", "serializedName": "requiredNullablePrimitive", - "description": "required nullable primitive type", + "doc": "required nullable primitive type", "type": { "$id": "176", "kind": "nullable", @@ -1706,7 +1706,7 @@ "kind": "property", "name": "requiredExtensibleEnum", "serializedName": "requiredExtensibleEnum", - "description": "required nullable extensible enum type", + "doc": "required nullable extensible enum type", "type": { "$id": "179", "kind": "nullable", @@ -1726,7 +1726,7 @@ "kind": "property", "name": "requiredFixedEnum", "serializedName": "requiredFixedEnum", - "description": "required nullable fixed enum type", + "doc": "required nullable fixed enum type", "type": { "$id": "181", "kind": "nullable", @@ -1755,7 +1755,7 @@ "kind": "property", "name": "requiredBytes", "serializedName": "requiredBytes", - "description": "Required bytes", + "doc": "Required bytes", "type": { "$id": "183", "kind": "bytes", @@ -1782,7 +1782,7 @@ "name": "Friend", "crossLanguageDefinitionId": "UnbrandedTypeSpec.NotFriend", "usage": "Output,Spread,Json", - "description": "this is not a friendly model but with a friendly name", + "doc": "this is not a friendly model but with a friendly name", "decorators": [], "properties": [ { @@ -1790,7 +1790,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "name of the NotFriend", + "doc": "name of the NotFriend", "type": { "$id": "186", "kind": "string", @@ -1813,7 +1813,7 @@ "name": "ProjectedModel", "crossLanguageDefinitionId": "UnbrandedTypeSpec.ModelWithProjectedName", "usage": "Output,Spread,Json", - "description": "this is a model with a projected name", + "doc": "this is a model with a projected name", "decorators": [], "properties": [ { @@ -1821,7 +1821,7 @@ "kind": "property", "name": "name", "serializedName": "name", - "description": "name of the ModelWithProjectedName", + "doc": "name of the ModelWithProjectedName", "type": { "$id": "189", "kind": "string", @@ -1852,13 +1852,13 @@ { "$id": "191", "Name": "UnbrandedTypeSpecClient", - "Description": "This is a sample typespec project.", + "Doc": "This is a sample typespec project.", "Operations": [ { "$id": "192", "Name": "sayHi", "ResourceName": "UnbrandedTypeSpec", - "Description": "Return hi", + "Doc": "Return hi", "Accessibility": "public", "Parameters": [ { @@ -1983,7 +1983,7 @@ "$id": "203", "Name": "helloAgain", "ResourceName": "UnbrandedTypeSpec", - "Description": "Return hi again", + "Doc": "Return hi again", "Accessibility": "public", "Parameters": [ { @@ -2134,7 +2134,7 @@ "$id": "216", "Name": "noContentType", "ResourceName": "UnbrandedTypeSpec", - "Description": "Return hi again", + "Doc": "Return hi again", "Accessibility": "public", "Parameters": [ { @@ -2183,7 +2183,7 @@ "$id": "221", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "222", "kind": "constant", @@ -2286,7 +2286,7 @@ "$id": "229", "Name": "helloDemo2", "ResourceName": "UnbrandedTypeSpec", - "Description": "Return hi in demo2", + "Doc": "Return hi in demo2", "Accessibility": "public", "Parameters": [ { @@ -2348,14 +2348,14 @@ "$id": "234", "Name": "createLiteral", "ResourceName": "UnbrandedTypeSpec", - "Description": "Create with literal value", + "Doc": "Create with literal value", "Accessibility": "public", "Parameters": [ { "$id": "235", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "236", "kind": "constant", @@ -2458,7 +2458,7 @@ "$id": "243", "Name": "helloLiteral", "ResourceName": "UnbrandedTypeSpec", - "Description": "Send literal parameters", + "Doc": "Send literal parameters", "Accessibility": "public", "Parameters": [ { @@ -2601,7 +2601,7 @@ "$id": "257", "Name": "topAction", "ResourceName": "UnbrandedTypeSpec", - "Description": "top level method", + "Doc": "top level method", "Accessibility": "public", "Parameters": [ { @@ -2692,7 +2692,7 @@ "$id": "265", "Name": "topAction2", "ResourceName": "UnbrandedTypeSpec", - "Description": "top level method2", + "Doc": "top level method2", "Accessibility": "public", "Parameters": [ { @@ -2754,14 +2754,14 @@ "$id": "270", "Name": "patchAction", "ResourceName": "UnbrandedTypeSpec", - "Description": "top level patch", + "Doc": "top level patch", "Accessibility": "public", "Parameters": [ { "$id": "271", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "272", "kind": "constant", @@ -2864,14 +2864,14 @@ "$id": "279", "Name": "anonymousBody", "ResourceName": "UnbrandedTypeSpec", - "Description": "body parameter without body decorator", + "Doc": "body parameter without body decorator", "Accessibility": "public", "Parameters": [ { "$id": "280", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "281", "kind": "constant", @@ -2974,14 +2974,14 @@ "$id": "288", "Name": "friendlyModel", "ResourceName": "UnbrandedTypeSpec", - "Description": "Model can have its friendly name", + "Doc": "Model can have its friendly name", "Accessibility": "public", "Parameters": [ { "$id": "289", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "290", "kind": "constant", @@ -3141,14 +3141,14 @@ "$id": "302", "Name": "projectedNameModel", "ResourceName": "UnbrandedTypeSpec", - "Description": "Model can have its projected name", + "Doc": "Model can have its projected name", "Accessibility": "public", "Parameters": [ { "$id": "303", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "304", "kind": "constant", @@ -3251,7 +3251,7 @@ "$id": "311", "Name": "returnsAnonymousModel", "ResourceName": "UnbrandedTypeSpec", - "Description": "return anonymous model", + "Doc": "return anonymous model", "Accessibility": "public", "Parameters": [ { @@ -3313,7 +3313,7 @@ "$id": "316", "Name": "getUnknownValue", "ResourceName": "UnbrandedTypeSpec", - "Description": "get extensible enum", + "Doc": "get extensible enum", "Accessibility": "public", "Parameters": [ { @@ -3386,14 +3386,14 @@ "$id": "322", "Name": "internalProtocol", "ResourceName": "UnbrandedTypeSpec", - "Description": "When set protocol false and convenient true, then the protocol method should be internal", + "Doc": "When set protocol false and convenient true, then the protocol method should be internal", "Accessibility": "public", "Parameters": [ { "$id": "323", "Name": "contentType", "NameInRequest": "Content-Type", - "Description": "Body parameter's content type. Known values are application/json", + "Doc": "Body parameter's content type. Known values are application/json", "Type": { "$id": "324", "kind": "constant", @@ -3496,7 +3496,7 @@ "$id": "331", "Name": "stillConvenient", "ResourceName": "UnbrandedTypeSpec", - "Description": "When set protocol false and convenient true, the convenient method should be generated even it has the same signature as protocol one", + "Doc": "When set protocol false and convenient true, the convenient method should be generated even it has the same signature as protocol one", "Accessibility": "public", "Parameters": [], "Responses": [ @@ -3524,7 +3524,7 @@ "$id": "333", "Name": "headAsBoolean", "ResourceName": "UnbrandedTypeSpec", - "Description": "head as boolean.", + "Doc": "head as boolean.", "Accessibility": "public", "Parameters": [ { @@ -3574,7 +3574,7 @@ "$id": "337", "Name": "WithApiVersion", "ResourceName": "UnbrandedTypeSpec", - "Description": "Return hi again", + "Doc": "Return hi again", "Accessibility": "public", "Parameters": [ {