[tor-bugs] #9778 [Onionoo]: Adding votes documents to Onionoo

[Tor Bug Tracker & Wiki]

#9778: Adding votes documents to Onionoo
-----------------------------+---------------------
     Reporter:  karsten      |      Owner:  karsten
         Type:  enhancement  |     Status:  new
     Priority:  normal       |  Milestone:
    Component:  Onionoo      |    Version:
   Resolution:               |   Keywords:
Actual Points:               |  Parent ID:
       Points:               |
-----------------------------+---------------------

Comment (by alphawolf):

 Replying to [comment:5 karsten]:


 > I like the idea of displaying this information in a tooltip.  Though I
 see two problems here:
 >
 > 1. We don't include which authorities voted on a given flag.  So if we
 decide for the `missing_flags` format, Atlas can't tell which authorities
 did vote on the flag.  Though it could display in the tooltip which
 authorities did not vote on the flag.
 >

 What if we include an array of authorities that voted in the current
 consensus?  Since the document is designed for machine consumption, we
 don't actually need to repeat the authority names under each
 "missing_flags"/"extra_flags" property.  Instead, these properties become
 arrays of arrays, with the index of each subarray corresponding to the
 index of the authority.  Like so:

 {{{
 {
     "relays_published": "2013-09-19 09:00:00",
     "authorities": [
         "Faravahar",
         "dannenberg",
         "dizum",
         "gabelmoo",
         "maatuska",
         "moria1",
         "urras"
     ],
     "relays": [
         {
             "nickname": "gabelmoo",
             "fingerprint": "F2044413DAC2E02E3D6BCF4735A19BCA1DE97281",
             "missing_flags": [
                 [],[],[],["HSDir","Stable"],[],[],[]
             ],
             "measured": {
                 "moria1": 9
             }
         }
     ],
     "bridges_published": "2013-09-19 08:37:03",
     "bridges": []
 }
 }}}
 In this case, `missing_flags[3]` corresponds to `authorities[3]`
 ("gabelmoo") and contains `["HSDir","Stable"]`.  The remaining 6 listed
 authorities can be assumed to have voted for the flags. Turtles and tor26
 took the day off, so they are not listed.

 The "Named" and "Unnamed" flags present a problem currently, but it is my
 understanding that they are on their way out.  Are there other flags that
 only a subset of the authorities vote on?

 >
 > 2. There's nothing that the user could hover over to learn about flags
 in votes that didn't make it into the consensus.  This would be the
 tooltip that would display `extra_flags`.  Not sure how to solve this.
 >

 Atlas could show the flags grayed out, in red, or with a strike through
 (or a combination) if a flag was not in the consensus.  Hovering over the
 "inactive" flag could then show the missing/extra flags tooltip.

 While we're working out the document format, I propose shortening the
 flags to a 1-2 character token each.  The property names under "relays"
 could also be shortened.  Saving a few bytes in this area will end up
 saving megabytes when votes for all relays are requested.

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