googleapis / googleapis/google-api-go-client
Typo "administators" in androidmanagement v1 Policy.longSupportMessage description
- Dominant language
- Go
- Stars
- 4.5k
- Forks
- 1.5k
- Avg merge
- 1d 15h
- Merged PRs (30d)
- 32
Description
### Client
`google.golang.org/api/androidmanagement/v1` (google-api-go-client), version v0.282.0
### Description
The description for the `Policy.longSupportMessage` field misspells "administrators" as "administators". This text originates from the Android Management API discovery document (`androidmanagement:v1`, revision `20260521`), so the typo appears in every generated client library (Go, Java, Python, Node.js, .NET, PHP, Ruby) and in the public REST reference documentation, not just the Go client.
### Location
- Discovery document `androidmanagement-api.json`, `schemas.Policy.properties.longSupportMessage.description`:
"longSupportMessage": {
"$ref": "UserFacingMessage",
"description": "A message displayed to the user in the device administators settings screen."
}
- Generated Go client `androidmanagement/v1/androidmanagement-gen.go`:
// LongSupportMessage: A message displayed to the user in the device
// administators settings screen.
LongSupportMessage *UserFacingMessage `json:"longSupportMessage,omitempty"`
- Public REST reference: https://developers.google.com/android/management/reference/rest/v1/enterprises.policies (the `longSupportMessage` field on the `Policy` resource)
### Expected
> A message displayed to the user in the device **administrators** settings screen.
### Actual
> A message displayed to the user in the device **administators** settings screen.
### Impact
Purely cosmetic — no behavioral effect. It is user-visible in tooling that surfaces AMAPI field descriptions (for example, policy editors that render the schema descriptions as help text), which is where we hit it.
### Suggested fix
Correct "administators" → "administrators" in the `Policy.longSupportMessage` description in the androidmanagement v1 discovery document; the change will propagate to all generated clients and the REST reference on the next regeneration.
Contributor guide
Research direction
Start with the androidmanagement-api.json discovery document at schemas.Policy.properties.longSupportMessage.description, then compare the generated comment in androidmanagement/v1/androidmanagement-gen.go. Correct the spelling at the discovery-document source and verify that regeneration produces “administrators” in the Go client description and related reference output.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 72/100