docs(api/runway): trim package and schema doc comments

Drop the redundant "for non-Go clients" qualifier and the published-contract
rationale from the package doc (it lives in the RFC), keeping the doc focused.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: behinddwalls

api/runway/messagequeue/merge.go

@@ -13,11 +13,8 @@
 // limitations under the License.
 
 // Package messagequeue holds Runway's external message-queue contract: the wire
-// payloads for the merge queues Runway owns, alongside the JSON Schema (see the
-// embedded *.schema.json) that defines them for non-Go clients. This is a
-// published, cross-domain contract — hence its home under api/ — so the payloads
-// carry the full data needed to perform a merge attempt rather than opaque
-// entity IDs that only Runway could resolve.
+// payloads for the merge queues Runway owns, alongside the JSON Schema that
+// defines them.
 //
 // One contract serves two queue pairs because a merge-conflict check is a dry
 // run of a merge: Runway applies the same ordered Steps onto the same target

api/runway/messagequeue/schema.go

@@ -16,15 +16,14 @@ package messagequeue
 
 import _ "embed"
 
-// MergeRequestSchema is the JSON Schema (draft 2020-12) defining the MergeRequest
-// wire payload. It is the language-neutral contract a non-Go client validates
-// against; the Go MergeRequest type in this package is the matching binding.
+// MergeRequestSchema is the JSON Schema (draft 2020-12) for the MergeRequest
+// wire payload; the Go MergeRequest type in this package is the matching binding.
 //
 //go:embed merge_request.schema.json
 var MergeRequestSchema []byte
 
-// MergeResultSchema is the JSON Schema (draft 2020-12) defining the MergeResult
-// wire payload, the counterpart to MergeRequestSchema for the signal queues.
+// MergeResultSchema is the JSON Schema (draft 2020-12) for the MergeResult wire
+// payload, the counterpart to MergeRequestSchema for the signal queues.
 //
 //go:embed merge_result.schema.json
 var MergeResultSchema []byte