protocolbuffers / protocolbuffers/protocolbuffers.github.io

Encoding Repeated Elements Discussion Wrong

Đang mở
#293 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Ngôn ngữ chính
HTML
Star
69
Fork
179
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

I'm brand new to Protobuf, so maybe I have this all wrong, but as best as I could make out, including by experimentation using protoc, the documentation on the encoding of repeated elements is wrong.

It says that if we "construct a Test4 message with d set to "hello", and e set to 1, 2, and 3, this could be encoded as 3206038e029ea705, or written out as Protoscope:"

4: {"hello"}
6: {3 270 86942}

First, the encoding given appears to be just for the values of e, not for the entire Test4 message.
Second, it appears the encoding is for e being set to 3, 270, and 86942, not 1, 2, and 3.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Xác định tài liệu chứa ví dụ được trích dẫn về Test4 và repeated-elements, sau đó tái hiện ví dụ đó bằng protoc như được mô tả trong issue. Xác minh xem chuỗi byte và các giá trị Protoscope có khớp với thông điệp đã nêu hay không, rồi cập nhật ví dụ và phần văn bản giải thích để chúng thống nhất.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
42/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.