[metrics-bugs] #26857 [Metrics/Website]: Add new page with specifications for reproducing graphs and tables

[Tor Bug Tracker & Wiki]

#26857: Add new page with specifications for reproducing graphs and tables
-----------------------------+--------------------------------
 Reporter:  karsten          |          Owner:  karsten
     Type:  enhancement      |         Status:  needs_revision
 Priority:  Medium           |      Milestone:
Component:  Metrics/Website  |        Version:
 Severity:  Normal           |     Resolution:
 Keywords:                   |  Actual Points:
Parent ID:                   |         Points:
 Reviewer:  irl              |        Sponsor:  Sponsor13
-----------------------------+--------------------------------

Comment (by karsten):

 Replying to [comment:3 irl]:
 > There is inconsistent use of anchors with headings.

 Hmm, can you give an example? Not exactly sure what you mean.

 >   is used where I think &emdash; was intended (in any case,  
 looks weird).

 Changed to &emdash;.

 > Inconsistent use of spaces between digits and percent signs.

 Removed spaces.

 > s/equivalant/equivalent/
 > s/suceeded/succeeded/
 > s/section fo the consensus/section of the consensus/

 Fixed.

 > Inconsistent use of inter-quartile vs. interquartile.

 Changed to interquartile.

 > > skip this line to avoid including statistics in the aggregation that
 have very likely been reported and processed before
 >
 > It's not clear to me in the users section, especially in the above
 quote, how time works. Is the assumption that you are always calculating
 the latest statistics, or can you use this method to calculate statistics
 at any point in time?

 It's independent of when you're calculating statistics. The idea is just
 to avoid processing statistics that have been written long before the
 descriptor is published, because the same statistics were likely included
 in earlier descriptors. Practically, this is relevant, because we're only
 touching dates in the database covering the past week. It's to some extent
 an implementation detail, but I fear that people might come up with
 slightly different results if a relay first includes statistics after a
 downtime of over 1 week.

 Does this make sense? Any idea how to phrase it more clearly?

 > > what transports they use
 >
 > Can we instead say "pluggable transports" and link to the pluggable
 transport entry in the glossary? There are other terms that should
 probably be linked to the glossary too.

 Ah, the glossary. Yes, I'll link terms.

 Regarding "transports" vs. "pluggable transports", I guess that
 "transports" includes all "pluggable transports" along with the default OR
 protocol. I'll take another look while linking terms to the glossary which
 one we should be using. But even if we're talking about "transports", we
 could easily link to the "pluggable transports" glossary entry.

 Working on the glossary links now and making more changes as soon as I
 know better what to improve. Thanks!

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/26857#comment:4>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online