protocolbuffers / protocolbuffers/protocolbuffers.github.io

Encoding Repeated Elements Discussion Wrong

Aperta
#293 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Lingua principale
HTML
Stelle
69
Fork
179
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

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.

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Individua la documentazione contenente l’esempio citato di Test4 e repeated-elements, quindi riproducilo con protoc come descritto nell’issue. Verifica se la sequenza di byte e i valori di Protoscope corrispondono al messaggio indicato, e aggiorna l’esempio e il testo esplicativo in modo che siano coerenti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
3/5
Tempo stimato
1-2 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
42/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.