Merge pull request #127 from Logofile/sync

Documentation update

Author: Logofile

content/news/_index.md

@@ -16,7 +16,7 @@ per-release topics, as some content is not tied to a version.
 The following news topics provide information in the reverse order in which it
 was released.
 
-*   [February 27, 2024](/news/2024-02-05) - Dropping
+*   [February 27, 2024](/news/2024-02-27) - Dropping
     support for older versions of Ruby
 *   [February 5, 2024](/news/2024-02-05) - Breaking
     changes in Java, C++, and Python in the 26.x line.

content/programming-guides/style.md

@@ -43,9 +43,10 @@ the protocol buffer type definitions.
 
 ## Message and Field Names {#message-field-names}
 
-Use PascalCase (with an initial capital) for message names – for example,
-`SongServerRequest`. Use lower_snake_case for field names (including oneof field
-and extension names) – for example, `song_name`.
+Use PascalCase (with an initial capital) for message names: `SongServerRequest`.
+Prefer to capitalize abbreviations as single words: `GetDnsRequest` rather than
+`GetDNSRequest`. Use lower_snake_case for field names, including oneof field and
+extension names: `song_name`.
 
 ```proto
 message SongServerRequest {

content/reference/protobuf/proto2-spec.md

@@ -408,7 +408,7 @@ service SearchService {
 ## Proto file {#proto_file}
 
 ```
-proto = syntax { import | package | option | topLevelDef | emptyStatement }
+proto = [syntax] { import | package | option | topLevelDef | emptyStatement }
 topLevelDef = message | enum | extend | service
 ```
 

content/reference/protobuf/proto3-spec.md

@@ -338,7 +338,7 @@ service SearchService {
 ## Proto File {#proto_file}
 
 ```
-proto = syntax { import | package | option | topLevelDef | emptyStatement }
+proto = [syntax] { import | package | option | topLevelDef | emptyStatement }
 topLevelDef = message | enum | service
 ```