Skip to content

Commit 3b9a251

Browse files
Protocol Buffer TeamLogofile
authored andcommitted
This change includes:
* Adds alt text to an image in the overview topic * Replaces an image used in the proto2 and proto3 topics * Adds to the list of languages that cannot use public imports (proto3.md) * Adds a disclaimer to the proto-limits.md topic that the information is crowdsourced and may not be accurate PiperOrigin-RevId: 656471537 Change-Id: I15275bd0d074c2c13ce5538c6e295c73bb3e2e3b
1 parent d933980 commit 3b9a251

File tree

4 files changed

+11
-4
lines changed

4 files changed

+11
-4
lines changed
167 KB
Loading

content/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,7 @@ Many projects use protocol buffers, including the following:
185185

186186
The following diagram shows how you use protocol buffers to work with your data.
187187

188-
![](/images/protocol-buffers-concepts.png) \
188+
![Compilation workflow showing the creation of a proto file, generated code, and compiled classes](/images/protocol-buffers-concepts.png) \
189189
**Figure 1. Protocol buffers workflow**
190190

191191
The code generated by protocol buffers provides utility methods to retrieve data

content/programming-guides/proto-limits.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,11 @@ type = "docs"
88
This topic documents the limits to the number of supported elements (fields,
99
enum values, and so on) in proto schemas.
1010

11+
This information is a collection of discovered limitations by many engineers,
12+
but is not exhaustive and may be incorrect/outdated in some areas. As you
13+
discover limitations in your work, contribute those to this document to help
14+
others.
15+
1116
## Number of Fields {#fields}
1217

1318
Message with only singular proto fields (such as Boolean):
@@ -28,8 +33,8 @@ specs.
2833

2934
## Number of Values in an Enum {#enum}
3035

31-
The lowest limit is ~1700 values, in Java. Other languages have different
32-
limits.
36+
The lowest limit is ~1700 values, in Java (fix available
37+
go/java-large-enum-support). Other languages have different limits.
3338

3439
## Total Size of the Message {#total}
3540

content/programming-guides/proto3.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -769,7 +769,9 @@ Instead of moving the `.proto` file directly and updating all the call sites in
769769
a single change, you can put a placeholder `.proto` file in the old location to
770770
forward all the imports to the new location using the `import public` notion.
771771

772-
**Note that the public import functionality is not available in Java.**
772+
**Note that the public import functionality is not available in Java, Kotlin,
773+
TypeScript, JavaScript, GCL, as well as C++ targets that use protobuf static
774+
reflection.**
773775

774776
`import public` dependencies can be transitively relied upon by any code
775777
importing the proto containing the `import public` statement. For example:

0 commit comments

Comments
 (0)