[tor-bugs] #17919 [Onionoo]: Document history objects better (was: Implement "example request" for history object in documentation of Onionoo)

Tor Bug Tracker & Wiki blackhole at torproject.org
Tue Dec 22 18:51:58 UTC 2015


#17919: Document history objects better
---------------------------+-----------------------------------
 Reporter:  seansaito      |          Owner:  karsten
     Type:  task           |         Status:  needs_information
 Priority:  Medium         |      Milestone:
Component:  Onionoo        |        Version:
 Severity:  Normal         |     Resolution:
 Keywords:  documentation  |  Actual Points:
Parent ID:                 |         Points:
  Sponsor:                 |
---------------------------+-----------------------------------
Changes (by karsten):

 * status:  new => needs_information


Comment:

 Hi seansaito,

 Replying to [ticket:17919 seansaito]:
 > * Can I query the history object for individual relays?

 Ah, no.  History objects are part of other documents, like the bandwidth
 document.

 > * What data does a history object contain?

 A history object contains graph data, which can be anything from written
 bytes over consensus weights to uptime.

 > * How far back does a history object go?

 5 years is the upper limit, though we could extend that to 10 or 15 years
 if needed in the future.  But for now, 5 years.

 Would you want to take a look at the various history objects contained in
 the different document types and then suggest how we might be able to
 document this part better in the spec?

 All the best,
 Karsten

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


More information about the tor-bugs mailing list