This documentation change includes the following:

* Creates a page with all of the V30 breaking changes (so far) included
* Adds information about the *Value Well-Known Types now being obsolete
* Fixes the order of topics in the Rust documentation

PiperOrigin-RevId: 691529077, 691384180, 689952786
Change-Id: I21e6460efe36dff593598eb1e238d114323e2eee

Author: Protocol Buffer Team

content/news/v30.md

@@ -0,0 +1,326 @@
++++
+title = "News Announcements for Version 30.x"
+linkTitle = "Version 30.x"
+toc_hide = "true"
+description = "Changes announced for Protocol Buffers version 30.x."
+type = "docs"
++++
+
+The following announcements are specific to Version 30.x. For information
+presented chronologically, see [News](/news).
+
+The following sections cover planned breaking changes in the v30 release,
+expected in 2025 Q1. These describe changes as we anticipate them being
+implemented, but due to the flexible nature of software some of these changes
+may not land or may vary from how they are described in this topic.
+
+## Changes in C++ {#cpp}
+
+C++ will bump its major version from 5.29.x to 6.30.x.
+
+### Descriptor APIs {#descriptor-apis}
+
+v30 will update return types in descriptor (such as `full_name`) to be
+`absl::string_view`. This opens up memory savings in descriptors.
+
+v28 introduced the `PROTOBUF_FUTURE_STRING_VIEW_RETURN_TYPE` macro, which you
+can use in the meantime to enable the updated return type ahead of the breaking
+release. The v30 release will flip the default and remove the macro.
+
+### ctype Removed from FieldDescriptor Options {#ctype-removed}
+
+v30 will stop exposing the `ctype` from `FieldDescriptor` options. You can use
+the `FieldDescriptor::cpp_string_type()` API, added in the
+[v28 release](https://github.com/protocolbuffers/protobuf/releases/tag/v28.0),
+in its place.
+
+### Replace CMake Submodules with Fetched Deps {#replace-cmake-submods}
+
+v30 will remove submodules and switches to upb's old CMake pattern of fetching
+dependencies.
+
+If you use installed packages, you won't be affected. It could break some CMake
+workflows.
+
+### Remove Deprecated APIs {#remove-deprecated}
+
+v30 will remove the following public runtime APIs, which have been marked
+deprecated (such as `ABSL_DEPRECATED`) for at least one minor or major release
+and that are obsolete or replaced.
+
+#### Arena::CreateMessage
+
+**API:**
+[`Arena::CreateMessage`](https://github.com/protocolbuffers/protobuf/blob/f4b57b98b08aec8bc52e6a7b762edb7a1b9e8883/src/google/protobuf/arena.h#L179)
+
+**Replacement:**
+[`Arena::Create`](https://github.com/protocolbuffers/protobuf/blob/f4b57b98b08aec8bc52e6a7b762edb7a1b9e8883/src/google/protobuf/arena.h#L191)
+
+#### Arena::GetArena
+
+**API:**
+[`Arena::GetArena`](https://github.com/protocolbuffers/protobuf/blob/237332ef92daf83a53e76decd6ac43c3fcee782b/src/google/protobuf/arena.h#L346)
+
+**Replacement:** `value->GetArena()`
+
+#### RepeatedPtrField::ClearedCount
+
+**API:**
+[`RepeatedPtrField::ClearedCount`](https://github.com/protocolbuffers/protobuf/blame/f4b57b98b08aec8bc52e6a7b762edb7a1b9e8883/src/google/protobuf/repeated_ptr_field.h#L1157)
+
+**Replacement:** Migrate to Arenas
+([migration guide](https://protobuf.dev/support/migration/#cleared-elements)).
+
+#### JsonOptions
+
+**API:**
+[`JsonOptions`](https://github.com/protocolbuffers/protobuf/blob/f4b57b98b08aec8bc52e6a7b762edb7a1b9e8883/src/google/protobuf/util/json_util.h#L22)
+
+**Replacement:** `JsonPrintOptions`
+
+### Dropping C++14 Support {#drop-cpp-14}
+
+This release will drop C++ 14 as the minimum supported version and raise it to
+17, as per the
+[Foundational C++ Support matrix](https://github.com/google/oss-policies-info/blob/main/foundational-cxx-support-matrix.md).
+
+Per [our policies](https://protobuf.dev/support/version-support/), we do not
+consider this to be a breaking change.
+
+## Changes in JRuby {#jruby}
+
+v30 will flip the default implementation for JRuby to FFI, which may be breaking
+for some JRuby users.
+
+Note that this change doesn't create a Ruby major version bump because JRuby is
+[not officially supported](/support/version-support/#ruby).
+
+## Changes in Python {#python}
+
+Python will bump its major version from 5.29.x to 6.30.x.
+
+### Dropping Python 3.8 Support
+
+As per our official Python support policy, we will be dropping support for
+Python 3.8 and lower. This means the minimum supported Python version is 3.9.
+
+### Remove bazel/system_python.bzl Alias {#python-remove-alias}
+
+v30 will remove the legacy `bazel/system_python.bzl` alias.
+
+Remove direct references to `system_python.bzl` in favor of using
+`protobuf_deps.bzl` instead. Use `python/dist/system_python.bzl` where it was
+moved
+[in v5.27.0](https://github.com/protocolbuffers/protobuf/commit/d7f032ad1596ceeabd45ca1354516c39b97b2551)
+if you need a direct reference.
+
+### Field Setter Validation Changes {#python-setter-validation}
+
+Python's and upb's field setters will be fixed in v30 to validate closed enums
+under edition 2023. Closed enum fields updated with invalid values will generate
+errors.
+
+### Remove Deprecated APIs {#python-remove-apis}
+
+v30 will remove the following public runtime APIs, which have been marked
+deprecated for at least one minor or major release and are obsolete or replaced.
+
+#### Reflection Methods
+
+**APIs:**
+[`reflection.ParseMessage`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/reflection.py#L40),
+[`reflection.MakeClass`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/reflection.py#L66)
+
+**Replacement:** `message_factory.GetMessageClass()`
+
+#### RPC Service Interfaces
+
+**APIs:**
+[`service.RpcException`](https://github.com/protocolbuffers/protobuf/blob/21c545c8c5cec0b052dc7715b778f0353d37d02c/python/google/protobuf/service.py#L23),
+[`service.Service`](https://github.com/protocolbuffers/protobuf/blob/21c545c8c5cec0b052dc7715b778f0353d37d02c/python/google/protobuf/service.py#L28),
+[`service.RpcController`](https://github.com/protocolbuffers/protobuf/blob/21c545c8c5cec0b052dc7715b778f0353d37d02c/python/google/protobuf/service.py#L97),
+and
+[`service.RpcChannel`](https://github.com/protocolbuffers/protobuf/blob/21c545c8c5cec0b052dc7715b778f0353d37d02c/python/google/protobuf/service.py#L180)
+
+**Replacement:** Starting with version 2.3.0, RPC implementations should not try
+to build on these, but should instead provide code generator plugins which
+generate code specific to the particular RPC implementation.
+
+#### MessageFactory and SymbolDatabase Methods
+
+**APIs:**
+[`MessageFactory.GetPrototype`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/message_factory.py#L145),
+[`MessageFactory.CreatePrototype`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/message_factory.py#L165),
+[`MessageFactory.GetMessages`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/message_factory.py#L185),
+[`SymbolDatabase.GetPrototype`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/symbol_database.py#L54),
+[`SymbolDatabase.CreatePrototype`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/symbol_database.py#L60),
+and
+[`SymbolDatabase.GetMessages`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/symbol_database.py#L66)
+
+**Replacement:** `message_factory.GetMessageClass()` and
+`message_factory.GetMessageClassesForFiles()`.
+
+#### GetDebugString
+
+**APIs:**
+[`GetDebugString`](https://github.com/protocolbuffers/protobuf/blob/7f395af40e86e00b892e812beb67a03564884756/python/google/protobuf/pyext/descriptor.cc#L1510)
+
+**Replacement:**
+
+No replacement. It's only in Python C++ which is no longer released. It is not
+supported in pure Python or UPB.
+
+## Changes in Objective-C {#objc}
+
+**This will be the first breaking release for Objective-C**.
+
+Objective-C will bump its major version from 3.x.x to 4.30.x.
+
+### Overhaul Unknown Field Handling APIs Deprecating Most of the Existing APIs {#objc-field-handling}
+
+v30 will deprecate `GPBUnknownFieldSet` and replace it with `GPBUnknownFields`.
+The new type will preserve the ordering of unknown fields from the original
+input or API calls, to ensure any semantic meaning to the ordering is maintained
+when a message is written back out.
+
+As part of this, the `GPBUnknownField` type also has its APIs changed, with
+almost all of the existing APIs becoming deprecated and new ones added.
+
+Deprecated property APIs:
+
+*   `varintList`
+*   `fixed32List`
+*   `fixed64List`
+*   `lengthDelimitedList`
+*   `groupList`
+
+Deprecated modification APIs:
+
+*   `addVarint:`
+*   `addFixed32:`
+*   `addFixed64:`
+*   `addLengthDelimited:`
+*   `addGroup:`
+
+Deprecated initializer `initWithNumber:`.
+
+New property APIs:
+
+*   `type`
+*   `varint`
+*   `fixed32`
+*   `fixed64`
+*   `lengthDelimited`
+*   `group`
+
+This type will model a single field number in its value, rather than *grouping*
+all the values for a given field number. The APIs for creating new fields are
+the `add*` APIs on the `GPBUnknownFields` class.
+
+v30 will also deprecate `-[GPBMessage unknownFields]`. In its place, there will
+be new APIs to extract and update the unknown fields of the message.
+
+### Remove Deprecated APIs {#objc-remove-apis}
+
+v30 will remove the following public runtime APIs, which have been marked
+deprecated for at least one minor or major release and are obsolete or replaced.
+
+#### GPBFileDescriptor
+
+**API:**
+[-[`GPBFileDescriptor` syntax]](https://github.com/protocolbuffers/protobuf/blob/44bd65b2d3c0470d91a23cc14df5ffb1ab0af7cd/objectivec/GPBDescriptor.h#L118-L119)
+
+**Replacement:** Obsolete.
+
+#### GPBMessage mergeFrom:extensionRegistry
+
+**API:**
+[-[`GPBMessage mergeFrom:extensionRegistry:`]](https://github.com/protocolbuffers/protobuf/blob/44bd65b2d3c0470d91a23cc14df5ffb1ab0af7cd/objectivec/GPBMessage.h#L258-L261)
+
+**Replacement:**
+[-[`GPBMessage mergeFrom:extensionRegistry:error:`]](https://github.com/protocolbuffers/protobuf/blob/44bd65b2d3c0470d91a23cc14df5ffb1ab0af7cd/objectivec/GPBMessage.h#L275-L277)
+
+#### GPBDuration timeIntervalSince1970
+
+**API:**
+[-[`GPBDuration timeIntervalSince1970`]](https://github.com/protocolbuffers/protobuf/blob/29fca8a64b62491fb0a2ce61878e70eda88dde98/objectivec/GPBWellKnownTypes.h#L95-L100)
+
+**Replacement:**
+[-[`GPBDuration timeInterval`]](https://github.com/protocolbuffers/protobuf/blob/29fca8a64b62491fb0a2ce61878e70eda88dde98/objectivec/GPBWellKnownTypes.h#L74-L89)
+
+#### GPBTextFormatForUnknownFieldSet
+
+**API:**
+[`GPBTextFormatForUnknownFieldSet()`](https://github.com/protocolbuffers/protobuf/blob/29fca8a64b62491fb0a2ce61878e70eda88dde98/objectivec/GPBUtilities.h#L32-L43)
+
+**Replacement:** Obsolete - Use
+[`GPBTextFormatForMessage()`](https://github.com/protocolbuffers/protobuf/blob/29fca8a64b62491fb0a2ce61878e70eda88dde98/objectivec/GPBUtilities.h#L20-L30),
+which includes any unknown fields.
+
+#### GPBUnknownFieldSet
+
+**API:**
+[`GPBUnknownFieldSet`](https://github.com/protocolbuffers/protobuf/blob/224573d66a0cc958c76cb43d8b2eb3aa7cdb89f2/objectivec/GPBUnknownFieldSet.h)
+
+**Replacement:**
+[`GPBUnknownFields`](https://github.com/protocolbuffers/protobuf/blob/224573d66a0cc958c76cb43d8b2eb3aa7cdb89f2/objectivec/GPBUnknownFields.h)
+
+#### GPBMessage unknownFields
+
+**API:**
+[`GPBMessage unknownFields` property](https://github.com/protocolbuffers/protobuf/blob/224573d66a0cc958c76cb43d8b2eb3aa7cdb89f2/objectivec/GPBMessage.h#L73-L76)
+
+**Replacement:**
+[-[`GPBUnknownFields initFromMessage:`]](https://github.com/protocolbuffers/protobuf/blob/224573d66a0cc958c76cb43d8b2eb3aa7cdb89f2/objectivec/GPBUnknownFields.h#L30-L38),
+[-[`GPBMessage mergeUnknownFields:extensionRegistry:error:`]](https://github.com/protocolbuffers/protobuf/blob/f26bdff7cc0bb7e8ed88253ba16f81614a26cf16/objectivec/GPBMessage.h#L506-L528),
+and
+[-[`GPBMessage clearUnknownFields`]](https://github.com/protocolbuffers/protobuf/blob/224573d66a0cc958c76cb43d8b2eb3aa7cdb89f2/objectivec/GPBMessage.h#L497-L504C9)
+
+### Remove Deprecated Runtime APIs for Old Gencode {#objc-remove-apis-gencode}
+
+This release will remove deprecated runtime methods that support the Objective-C
+gencode from before the 3.22.x release. The library will also issue a log
+message at runtime when old generated code is starting up.
+
+**API:** [`+[GPBFileDescriptor
+allocDescriptorForClass:file:fields:fieldCount:storageSize:flags:]`](https://github.com/protocolbuffers/protobuf/blob/1b44ce0feef45a78ba99d09bd2e5ff5052a6541b/objectivec/GPBDescriptor_PackagePrivate.h#L213-L220)
+
+**Replacement:** Regenerate with a current version of the library.
+
+**API:** [`+[GPBFileDescriptor
+allocDescriptorForClass:rootClass:file:fields:fieldCount:storageSize:flags:]`](https://github.com/protocolbuffers/protobuf/blob/1b44ce0feef45a78ba99d09bd2e5ff5052a6541b/objectivec/GPBDescriptor_PackagePrivate.h#L221-L229)
+
+**Replacement:** Regenerate with a current version of the library.
+
+**API:** [`+[GPBEnumDescriptor
+allocDescriptorForName:valueNames:values:count:enumVerifier:]`](https://github.com/protocolbuffers/protobuf/blob/1b44ce0feef45a78ba99d09bd2e5ff5052a6541b/objectivec/GPBDescriptor_PackagePrivate.h#L285-L291)
+
+**Replacement:** Regenerate with a current version of the library.
+
+**API:** [`+[GPBEnumDescriptor
+allocDescriptorForName:valueNames:values:count:enumVerifier:extraTextFormatInfo:]`](https://github.com/protocolbuffers/protobuf/blob/1b44ce0feef45a78ba99d09bd2e5ff5052a6541b/objectivec/GPBDescriptor_PackagePrivate.h#L292-L299)
+
+**Replacement:** Regenerate with a current version of the library.
+
+**API:**
+[`-[GPBExtensionDescriptor initWithExtensionDescription:]`](https://github.com/protocolbuffers/protobuf/blob/1b44ce0feef45a78ba99d09bd2e5ff5052a6541b/objectivec/GPBDescriptor_PackagePrivate.h#L317-L320)
+
+**Replacement:** Regenerate with a current version of the library.
+
+## Other Changes {#non-breaking}
+
+In addition to those breaking changes are some other changes worth noting. While
+the following are not considered breaking changes, they may still impact users.
+
+### Poison Pill Warnings {#poison}
+
+v30 will update poison pills to emit warnings for old gencode + new runtime
+combinations that work under the new rolling upgrade policy, but will break in
+the *next* major bump. For example, Java 4.x.x gencode should work against 5.x.x
+runtime but warn of upcoming breakage against 6.x.x runtime.
+
+### Changes to UTF-8 Enforcement in C# and Ruby {#utf-8-enforcement}
+
+v30 will includes a fix to make UTF-8 enforcement consistent across languages.
+Users with bad non-UTF8 data in string fields may see surfaced UTF-8 enforcement
+errors earlier.

content/reference/protobuf/google.protobuf.md

@@ -39,6 +39,19 @@ type = "docs"
 -   [`UInt64Value`](#uint64-value) (message)
 -   [`Value`](#value) (message)
 
+Well-Known Types that end in "`Value`" are wrapper messages for other types,
+such as `BoolValue` and `EnumValue`. These are now obsolete. The only reasons to
+use wrappers today would be:
+
+*   Wire compatibility with messages that already use them.
+*   If you want to put a scalar value into an `Any` message.
+
+In most cases, there are better options:
+
+*   For new messages, it's better to use regular explicit-presence fields
+    (`optional` in proto2/proto3, regular field in edition >= 2023).
+*   Extensions are generally a better option than `Any` fields.
+
 ## Any {#any}
 
 `Any` contains an arbitrary serialized message along with a URL that describes

content/reference/rust/building-rust-protos.md

@@ -1,6 +1,6 @@
 +++
 title = "Building Rust Protos"
-weight = 783
+weight = 784
 linkTitle = "Building Rust Protos"
 description = "Describes using Blaze to build Rust protos."
 type = "docs"

content/reference/rust/rust-design-decisions.md

@@ -1,6 +1,6 @@
 +++
 title = "Rust Proto Design Decisions"
-weight = 782
+weight = 785
 linkTitle = "Design Decisions"
 description = "Explains some of the design choices that the Rust Proto implementation makes."
 type = "docs"
@@ -23,7 +23,7 @@ implemented on top of existing protobuf implementations, or as we call these
 implementations: kernels.
 
 The biggest factor that goes into this decision was to enable zero-cost of
-adding Rust to a preexisting binary which already uses non-Rust Protobuf. Bby
+adding Rust to a preexisting binary which already uses non-Rust Protobuf. By
 enabling the implementation to be ABI-compatible with the C++ Protobuf generated
 code, it is possible to share Protobuf messages across the language boundary
 (FFI) as plain pointers, avoiding the need to serialize in one language, pass

content/reference/rust/rust-redaction.md

@@ -1,6 +1,6 @@
 +++
 title = "Redaction in Rust"
-weight = 785
+weight = 783
 linkTitle = "Redaction in Rust"
 description = "Describes redaction in Rust."
 type = "docs"