golang/go

net: clarify UDPConn Read behaviour documentation

Open

#31.991 geöffnet am 13. Mai 2019

Auf GitHub ansehen
 (3 Kommentare) (4 Reaktionen) (0 zugewiesene Personen)Go (19.008 Forks)batch import
DocumentationNeedsFixhelp wanted

Repository-Metriken

Stars
 (133.883 Stars)
PR-Merge-Metriken
 (Keine gemergten PRs in 30 T)

Beschreibung

The documentation for UPDConn.Read says that "Read implements the Conn Read method." However, UDP is not stream and Conn is described as "a generic stream-oriented network connection".

It would be nice to be able to know what the characteristics of Read are with respect to packets — whether Read only reads a packet at a time or not — without having to read the source.

See https://groups.google.com/forum/#!topic/golang-nuts/f_s3fGRgAF8

Contributor Guide

Research-Richtung
Untersuche die aktuelle Dokumentation von UDPConn.Read im Quellcode des Go net Pakets, lies die entsprechende Diskussion in golang nuts und schlage eine Klarstellung vor, ob Read jeweils ein Paket liest oder nicht.
Tech Stack
go
Domain
backend
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
GoGit
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
75