misc: better Kdocs on

0marperez · 0marperez · commit cbe008edb30d · 2025-02-24T22:04:59.000-05:00
diff --git a/codegen/smithy-kotlin-codegen-testutils/src/main/kotlin/software/amazon/smithy/kotlin/codegen/test/CodegenTestUtils.kt b/codegen/smithy-kotlin-codegen-testutils/src/main/kotlin/software/amazon/smithy/kotlin/codegen/test/CodegenTestUtils.kt
@@ -124,7 +124,8 @@ fun TestContext.responseMembers(shape: Shape, location: HttpBinding.Location = H
 }
 
 /**
- * Attempts to retrieve the request document members for HttpTrait-enabled protocols for operations, otherwise the shape members
+ * If the shape represents an operation, it attempts to retrieve the request document members for protocols enabled with HttpTrait.
+ * Otherwise, it retrieves the shape's members.
  * */
 fun TestContext.shapeMembers(shape: Shape, location: HttpBinding.Location = HttpBinding.Location.DOCUMENT): List<MemberShape> =
     when (shape) {

Original file line number	Diff line number	Diff line change
`@@ -124,7 +124,8 @@ fun TestContext.responseMembers(shape: Shape, location: HttpBinding.Location = H`
`124`	`124`	`}`
`125`	`125`
`126`	`126`	`/**`
`127`		`- * Attempts to retrieve the request document members for HttpTrait-enabled protocols for operations, otherwise the shape members`
	`127`	`+ * If the shape represents an operation, it attempts to retrieve the request document members for protocols enabled with HttpTrait.`
	`128`	`+ * Otherwise, it retrieves the shape's members.`
`128`	`129`	`* */`
`129`	`130`	`fun TestContext.shapeMembers(shape: Shape, location: HttpBinding.Location = HttpBinding.Location.DOCUMENT): List<MemberShape> =`
`130`	`131`	`when (shape) {`