<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto"><div></div><div><br></div><div>On 2 May 2018, at 18:34, juga <<a href="mailto:juga@riseup.net">juga@riseup.net</a>> wrote:<br><br></div><blockquote type="cite"><div><blockquote type="cite"><blockquote type="cite"><blockquote type="cite"><span>2. Format details</span><br></blockquote></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><blockquote type="cite"><span></span><br></blockquote></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><blockquote type="cite"><span>  Bandwidth measurements MUST contain the following > sections:</span><br></blockquote></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><blockquote type="cite"><span>  - Header (exactly once)</span><br></blockquote></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><blockquote type="cite"><span>  - Relays measurements (zero or more times)</span><br></blockquote></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span></span><br></blockquote></blockquote><blockquote type="cite"><blockquote type="cite"><span>Grammar suggestion: "Relay measurements".</span><br></blockquote></blockquote><blockquote type="cite"><span></span><br></blockquote><blockquote type="cite"><span>In this case, this would become "Relay measurement result".</span><br></blockquote><span></span><br><span>More accurate, though starts becoming a bit too long. The title should</span><br><span>probably become then: "Tor Bandwidth Measurements Results Document Format"</span><br><span>Any shorter suggestion?.</span></div></blockquote><br><div><span style="background-color: rgba(255, 255, 255, 0);">"Measurements Results" describes how the bandwidths are created by some</span></div><div><span style="background-color: rgba(255, 255, 255, 0);">generators. But a generator that believes self-reported results doesn't measure,</span></div><div><span style="background-color: rgba(255, 255, 255, 0);">it just aggregates. (As does a peerflow-style generator.)</span></div><div><br></div><div>"Document" is vague. Let's describe what the document is: a list.</div><div><br></div><div>Let's use:</div><div><span style="background-color: rgba(255, 255, 255, 0);">Tor Bandwidth List Format</span></div><div><br></div><div>What is the document?</div><div>A <span style="background-color: rgba(255, 255, 255, 0);">Tor Bandwidth List</span></div><div><br></div><div>How do I parse it?</div><div>Using the <span style="background-color: rgba(255, 255, 255, 0);">Tor Bandwidth List Format</span></div><div><br></div><div>Are there any similar formats?</div><div><span style="background-color: rgba(255, 255, 255, 0);">The Tor Directory List Format</span></div><div><a href="https://gitweb.torproject.org/torspec.git/tree/dir-list-spec.txt">https://gitweb.torproject.org/torspec.git/tree/dir-list-spec.txt</a></div><div><br></div><div>T</div><div><br></div></body></html>