|
8 | 8 | <link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&lang=en" rel="stylesheet"></link> |
9 | 9 | <link rel="shortcut icon" href="/assets/favicon.ico"> |
10 | 10 | <link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css"> |
11 | | - <link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=b939fb8f"> |
12 | | - <link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=b939fb8f"> |
| 11 | + <link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=67d5e94f"> |
| 12 | + <link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=67d5e94f"> |
13 | 13 | <script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script> |
14 | 14 | <script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script> |
15 | 15 | <script type="text/javascript"> |
|
18 | 18 | $('html').css('visibility', 'visible'); |
19 | 19 | }); |
20 | 20 | </script> |
21 | | - <script type="text/javascript" src="/assets/js/global.js?v=b939fb8f"></script> |
| 21 | + <script type="text/javascript" src="/assets/js/global.js?v=67d5e94f"></script> |
22 | 22 |
|
23 | 23 | <script type="text/javascript" src="/assets/js/syntax.js"></script> |
24 | 24 |
|
|
643 | 643 | </ul> |
644 | 644 | </li> |
645 | 645 | <li><a href="#further-reading">Further reading</a></li> |
| 646 | +<li><a href="#changelog">Changelog</a></li> |
646 | 647 | </ul> |
647 | 648 | </div> |
648 | 649 |
|
@@ -726,7 +727,9 @@ <h2 id="guidance">Guidance</h2> |
726 | 727 | followed by the suffix <code>_UNSPECIFIED</code>.<ul> |
727 | 728 | <li>An exception to this rule is if there is a clearly useful zero value. In |
728 | 729 | particular, if an enum needs to present an <code>UNKNOWN</code>, it is usually clearer |
729 | | - and more useful for it to be a zero value rather than having both.</li> |
| 730 | + and more useful for it to be a zero value rather than having both. The |
| 731 | + <code>UNKNOWN</code> value <strong>may</strong> be prefixed by the enum name as is typical for |
| 732 | + avoiding enum value name collisions.</li> |
730 | 733 | </ul> |
731 | 734 | </li> |
732 | 735 | <li>Enums which will only be used in a single message <strong>should</strong> be nested within that message. |
@@ -777,6 +780,10 @@ <h3 id="alternatives">Alternatives</h3> |
777 | 780 | <h2 id="further-reading">Further reading</h2> |
778 | 781 | <ul> |
779 | 782 | <li>For states, a special type of enum, see <a href="/216">AIP-216</a>.</li> |
| 783 | +</ul> |
| 784 | +<h2 id="changelog">Changelog</h2> |
| 785 | +<ul> |
| 786 | +<li><strong>2025-10-03</strong>: Added prefixing guidance for <code>UNKNOWN</code> value exception.</li> |
780 | 787 | </ul> |
781 | 788 | <footer> |
782 | 789 | Except as otherwise noted, the content of this page is licensed under the |
|
0 commit comments