Merge pull request #194 from Logofile/main

Documentation update

Author: Logofile

content/includes/version-tables.css

@@ -93,32 +93,38 @@ table.version-chart td.active {
 }
 
 /* latest release column */
+/*
+ * How to advance the selection of the latest release:
+ * Replace class 'y24q3' in the following selectors with 'y24q4' (the class
+ * referring to the quarter of the next release). Please also update this
+ * instruction as a courtesy to the next maintainer.
+ */
 
 /* visually replace 'yyQq' heading with string 'Latest' */
-table.version-chart th.latest-release span {
+table.version-chart th.y24q3 span {
   display: none;
 }
-table.version-chart th.latest-release::after {
+table.version-chart th.y24q3::after {
   content: "Latest"
 }
 
 /* draw a focus rectangle around the latest release column */
-table.version-chart th.latest-release {
+table.version-chart th.y24q3 {
   border-top: 2px solid #e06666 !important;
   border-left: 2px solid #e06666 !important;
   border-right: 2px solid #e06666 !important;
 }
-table.version-chart td.latest-release {
+table.version-chart td.y24q3 {
   font-weight: bold;
   border-left: 2px solid #e06666 !important;
   border-right: 2px solid #e06666 !important;
 }
-table.version-chart tr:last-child td.latest-release {
+table.version-chart tr:last-child td.y24q3 {
   border-bottom: 2px solid #e06666 !important;
 }
 
 /* future release columns */
-table.version-chart td:not(:has(~ .latest-release)):not(.latest-release) {
+table.version-chart td:not(:has(~ .y24q3)):not(.y24q3) {
   font-style: italic;
 }
 

content/reference/cpp/abseil.md

@@ -0,0 +1,61 @@
++++
+title = "Asbseil Support"
+weight = 530
+linkTitle = "Asbseil Support"
+description = "The C++ implementation of Protocol Buffers has an explicit dependency on Abseil."
+type = "docs"
++++
+
+In [version 22.x](/news/v22#abseil-dep), C++ protobuf
+added an explicit dependency on Abseil.
+
+## Bazel Support {#bazel}
+
+If you are using Bazel, to determine the version of Abseil that your protobuf
+version supports, you can use the `bazel mod` command:
+
+```shell
+$ bazel mod deps abseil-cpp --enable_bzlmod
+<root> (protobuf@30.0-dev)
+└───abseil-cpp@20240722.0
+    ├───bazel_skylib@1.7.1
+    ├───googletest@1.15.2
+    └───platforms@0.0.10
+```
+
+`bazel mod graph` produces the full output:
+
+```shell
+$ bazel mod graph --enable_bzlmod
+<root> (protobuf@30.0-dev)
+├───abseil-cpp@20240722.0
+│   ├───bazel_skylib@1.7.1 (*)
+│   ├───googletest@1.15.2 (*)
+│   └───platforms@0.0.10 (*)
+├───bazel_features@1.18.0
+│   └───bazel_skylib@1.7.1 (*)
+├───bazel_skylib@1.7.1
+│   ├───platforms@0.0.10 (*)
+│   └───rules_license@1.0.0 (*)
+├───googletest@1.15.2
+│   ├───abseil-cpp@20240722.0 (*)
+│   ├───platforms@0.0.10 (*)
+│   └───re2@2024-07-02
+...
+```
+
+## CMake Support {#cmake}
+
+Our CMake support is best-effort compared to Bazel. To check for support, try
+the following steps:
+
+1.  Run the `cmake .` command.
+2.  Open `_deps/absl-src/CMakeLists.txt`.
+
+Look for the following line:
+
+```
+project(absl LANGUAGES CXX VERSION 20240722)
+set(ABSL_SOVERSION "2407.0.0")
+include(CTest)
+```

content/reference/rust/rust-generated.md

@@ -2,9 +2,9 @@
 title = "Rust Generated Code Guide"
 weight = 782
 linkTitle = "Generated Code Guide"
+toc_hide = true
 description = "Describes the API of message objects that the protocol buffer compiler generates for any given protocol definition."
 type = "docs"
-toc_hide = "true"
 +++
 
 This page describes exactly what Rust code the protocol buffer compiler