docs(api): document verification and files on the compare endpoint (#39440)

`GET /repos/{owner}/{repo}/compare/{basehead}` reads `verification` and
`files` (both default true), the same as the commit endpoints do:

```go
verification := ctx.FormString("verification") == "" || ctx.FormBool("verification")
files := ctx.FormString("files") == "" || ctx.FormBool("files")
```

The spec only lists `output`, so generated clients cannot turn either
off. This documents both with the wording the commit endpoints already
use and regenerates the spec.

Co-authored-by: bircni <bircni@icloud.com>
This commit is contained in:
Roshan Ramani
2026-09-26 21:59:02 +05:30
committed by GitHub
parent 4eebefbce5
commit 3fac5059de
3 changed files with 36 additions and 0 deletions
+16
View File
@@ -20936,6 +20936,22 @@
],
"type": "string"
}
},
{
"description": "include verification for every commit (disable for speedup, default 'true')",
"in": "query",
"name": "verification",
"schema": {
"type": "boolean"
}
},
{
"description": "include a list of affected files for every commit (disable for speedup, default 'true')",
"in": "query",
"name": "files",
"schema": {
"type": "boolean"
}
}
],
"responses": {