Merge branch 'main' into type-import-base-flag

Author: timotheeguerin

.chronus/changes/docs-events-2026-8-11.md

@@ -0,0 +1,7 @@
+---
+changeKind: internal
+packages:
+  - "@typespec/events"
+---
+
+Add missing documentation on public declarations and members

.chronus/changes/docs-graphql-2026-8-11.md

@@ -0,0 +1,7 @@
+---
+changeKind: internal
+packages:
+  - "@typespec/graphql"
+---
+
+Add missing documentation on public declarations and members

.chronus/changes/docs-http-client-2026-8-11.md

@@ -0,0 +1,7 @@
+---
+changeKind: internal
+packages:
+  - "@typespec/http-client"
+---
+
+Add missing documentation on public declarations and members

.chronus/changes/docs-protobuf-2026-8-11.md

@@ -0,0 +1,7 @@
+---
+changeKind: internal
+packages:
+  - "@typespec/protobuf"
+---
+
+Add missing documentation on public declarations and members

packages/events/README.md

@@ -32,9 +32,9 @@ decorator.
 
 ##### Parameters
 
-| Name        | Type             | Description |
-| ----------- | ---------------- | ----------- |
-| contentType | `valueof string` |             |
+| Name        | Type             | Description                                     |
+| ----------- | ---------------- | ----------------------------------------------- |
+| contentType | `valueof string` | The content type of the event or event payload. |
 
 ##### Examples
 

packages/events/generated-defs/TypeSpec.Events.ts

@@ -45,6 +45,7 @@ export type EventsDecorator = (
  *   { done: false, @data @contentType("text/plain") value: string,}
  * }
  * ```
+ * @param contentType The content type of the event or event payload.
  */
 export type ContentTypeDecorator = (
   context: DecoratorContext,

packages/events/lib/decorators.tsp

@@ -41,6 +41,8 @@ extern dec events(target: Union);
  *   { done: false, @data @contentType("text/plain") value: string,}
  * }
  * ```
+ *
+ * @param contentType The content type of the event or event payload.
  */
 extern dec contentType(target: UnionVariant | ModelProperty, contentType: valueof string);
 

packages/graphql/README.md

@@ -107,9 +107,9 @@ and all of the interfaces' properties must be present and compatible.
 
 ##### Parameters
 
-| Name       | Type      | Description |
-| ---------- | --------- | ----------- |
-| interfaces | `Model[]` |             |
+| Name       | Type      | Description                                                                 |
+| ---------- | --------- | --------------------------------------------------------------------------- |
+| interfaces | `Model[]` | The models to compose into the target, each emitted as a GraphQL interface. |
 
 ##### Examples
 
@@ -199,9 +199,9 @@ The operations become fields on the GraphQL type with their parameters as argume
 
 ##### Parameters
 
-| Name       | Type                       | Description |
-| ---------- | -------------------------- | ----------- |
-| operations | `Operation \| Interface[]` |             |
+| Name       | Type                       | Description                                                                  |
+| ---------- | -------------------------- | ---------------------------------------------------------------------------- |
+| operations | `Operation \| Interface[]` | The operations, or interfaces of operations, to add to the target as fields. |
 
 ##### Examples
 
@@ -252,9 +252,9 @@ All types and operations within the namespace will be emitted to a single GraphQ
 
 ##### Parameters
 
-| Name    | Type                                      | Description |
-| ------- | ----------------------------------------- | ----------- |
-| options | [valueof `SchemaOptions`](#schemaoptions) |             |
+| Name    | Type                                      | Description                               |
+| ------- | ----------------------------------------- | ----------------------------------------- |
+| options | [valueof `SchemaOptions`](#schemaoptions) | Options for the schema, such as its name. |
 
 ##### Examples
 

packages/graphql/generated-defs/TypeSpec.GraphQL.ts

@@ -66,6 +66,7 @@ export type GraphqlInterfaceDecorator = (
  *   name: string;
  * }
  * ```
+ * @param interfaces The models to compose into the target, each emitted as a GraphQL interface.
  */
 export type ComposeDecorator = (
   context: DecoratorContext,
@@ -87,6 +88,7 @@ export type ComposeDecorator = (
  * }
  * // Emits: type Person { name: String!; followers(query: String!): [Person!]! }
  * ```
+ * @param operations The operations, or interfaces of operations, to add to the target as fields.
  */
 export type OperationFieldsDecorator = (
   context: DecoratorContext,
@@ -146,6 +148,7 @@ export type SubscriptionDecorator = (
  * }
  * // Emits: MyAPI.graphql
  * ```
+ * @param options Options for the schema, such as its name.
  */
 export type SchemaDecorator = (
   context: DecoratorContext,

packages/graphql/lib/interface.tsp

@@ -53,5 +53,7 @@ extern dec graphqlInterface(
  *   name: string;
  * }
  * ```
+ *
+ * @param interfaces The models to compose into the target, each emitted as a GraphQL interface.
  */
 extern dec compose(target: Model, ...interfaces: Model[]);