[tor-bugs] #14987 [Tor]: Settle on a name for descriptors

["Tor Bug Tracker & Wiki" <blackhole@xxxxxxxxxxxxxx>]

#14987: Settle on a name for descriptors
--------------------+------------------------
 Reporter:  atagar  |          Owner:  atagar
     Type:  defect  |         Status:  new
 Priority:  minor   |      Milestone:
Component:  Tor     |        Version:
 Keywords:          |  Actual Points:
Parent ID:          |         Points:
--------------------+------------------------
 As [https://trac.torproject.org/projects/tor/ticket/14784#comment:3
 discussed on #14784] we call self-published descriptors quite a few
 things...

 * 'GETINFO desc/*' and Stem call the main self-published descriptors
 **server descriptors**. Metrics also uses a "server-descriptor 1.0"
 annotation for them.
 * The dir-spec calls them **router descriptors**... usually. It opts for
 'server descriptor' in section 6.2.
 * CollecTor calls them **relay descriptors**.

 Having three different names is confusing for new contributors and...
 well, us too. We should standardize on a name.

 This primarily straddles Tor's spec, Stem, and CollecTor. Personally I'd
 like for us to standardize on **server descriptors** because it's codified
 in the Metrics annotation and classes Stem vends.

 Karsten, Nick: any objections? If not then I'm happy to provide a spec
 patch and file a CollecTor ticket for this.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/14987>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online
_______________________________________________
tor-bugs mailing list
tor-bugs@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs