[tor-bugs] #20946 [Core Tor/Fallback Scripts]: Make it easier to find contacts for a fallback list

[Tor Bug Tracker & Wiki]

#20946: Make it easier to find contacts for a fallback list
---------------------------------------+----------------------------------
 Reporter:  teor                       |          Owner:  (none)
     Type:  enhancement                |         Status:  new
 Priority:  Medium                     |      Milestone:  Tor: unspecified
Component:  Core Tor/Fallback Scripts  |        Version:
 Severity:  Normal                     |     Resolution:
 Keywords:  fallback                   |  Actual Points:
Parent ID:                             |         Points:  1
 Reviewer:                             |        Sponsor:
---------------------------------------+----------------------------------

Comment (by teor):

 These are the old wiki instructions:

 === d. Informing Relay Operators ===

 After "Generating the List", contact operators using the process in 'Group
 Emails' section above, BCC'ing each operator in the list. It aids
 transparency if you first post a draft list, and then allow the operators
 to make corrections. (Once you've emailed all the operators on the draft
 list, you only need email the operators whose relays were added or deleted
 from the final list. This makes it easier for you, and keeps the volume of
 email down.)

 Keep the info-level logs somewhere publicly accessible (a trac ticket is a
 good place), so that people can see exactly what decisions the script
 made.

 It can be helpful to label the list and logs with the date and time (in
 UTC) and the tor git commit used to generate the list. This aids others in
 reproducing the list. (Except for the network reachability and download
 time checks, which happen in real-time and are non-deterministic.)

 If you want to generate the same list, but with operator contact details,
 follow the steps in "Finding Broken Fallbacks".
 To find the contacts for an old list, follow those steps, but use:
 {{{
 -PERFORM_IPV4_DIRPORT_CHECKS = False if OUTPUT_CANDIDATES else True
 +PERFORM_IPV4_DIRPORT_CHECKS = False
 }}}
 {{{
 -OUTPUT_COMMENTS = True if OUTPUT_CANDIDATES else False
 +OUTPUT_COMMENTS = True
 }}}
 {{{
 -CONTACT_COUNT = True if OUTPUT_CANDIDATES else False
 +CONTACT_COUNT = True
 }}}
 {{{
 -OUTPUT_SORT_FIELD = 'contact' if OUTPUT_CANDIDATES else 'fingerprint'
 +OUTPUT_SORT_FIELD = 'contact'
 }}}
 {{{
 -BLACKLIST_EXCLUDES_WHITELIST_ENTRIES = True
 +BLACKLIST_EXCLUDES_WHITELIST_ENTRIES = False
 }}}
 {{{
 -MAX_DOWNTIME_DAYS = 0 if MUST_BE_RUNNING_NOW else 7
 +MAX_DOWNTIME_DAYS = 0
 }}}
 {{{
 -CUTOFF_RUNNING = .90
 -CUTOFF_V2DIR = .90
 -CUTOFF_GUARD = .90
 +CUTOFF_RUNNING = .0
 +CUTOFF_V2DIR = .0
 +CUTOFF_GUARD = .0
 }}}

 If you have the old OnionOO files, set:
 {{{
 -LOCAL_FILES_ONLY = False
 +LOCAL_FILES_ONLY = True
 }}}

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