Skip to content

Commit 6662f83

Browse files
authored
fix(AIP-192): Expand deprecated comment requirement to all components (#1198)
1 parent ead1131 commit 6662f83

1 file changed

Lines changed: 3 additions & 2 deletions

File tree

aip/general/0192.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -116,8 +116,8 @@ trademark owner's current branding.
116116

117117
### Deprecations
118118

119-
To deprecate a service or RPC, the `deprecated`
120-
[option](https://developers.google.com/protocol-buffers/docs/proto#options)
119+
To deprecate a component (service, method, message, field, enum, or enum value),
120+
the `deprecated` [option](https://developers.google.com/protocol-buffers/docs/proto#options)
121121
**must** be set to `true`, and the first line of the respective comment
122122
**must** start with `"Deprecated: "` and provide alternative solutions for
123123
developers. If there is no alternative solution, a deprecation reason **must**
@@ -144,6 +144,7 @@ of inadvertent omissions of the internal content annotation.
144144

145145
## Changelog
146146

147+
- **2023-08-11**: Expand deprecated comment requirement to all components.
147148
- **2021-04-20**: Added guidance for deprecated services and RPCs.
148149
- **2020-04-01**: Added guidance requiring absolute URLs for external links.
149150
- **2020-02-14**: Added guidance around the use of trademarked names.

0 commit comments

Comments
 (0)