fixesA

common/proto/table_definition.proto

@@ -542,8 +542,8 @@ message ColumnBehavior {
   // This is not an authorization boundary; data APIs still expose the column.
   bool hidden_from_forms = 6;
 
-  // Current public aliases for stable option values. Identity aliases equal the
-  // canonical value. Once renamed, public writes must use the current alias.
+  // Current public option names. For a renamed option, both fields contain its
+  // alias; the stored value is never disclosed. Public writes use the alias.
   repeated OptionValueAlias option_value_aliases = 7;
 }
 
@@ -581,7 +581,8 @@ message SetColumnPresentationResponse {
   int64 row_version = 4;
 }
 
-// One stable machine value and its optional user-visible/input alias.
+// One public option name. `value` identifies the option by its current public
+// alias and `alias` is its desired public alias; stored values remain internal.
 message OptionValueAlias {
   string value = 1;
   string alias = 2;