[tor-bugs] #33188 [Core Tor/Tor]: Tor Manual: Alphabetize Server and Directory Server Options

[Tor Bug Tracker & Wiki]

#33188: Tor Manual: Alphabetize Server and Directory Server Options
-------------------------------------------------+-------------------------
 Reporter:  swati                                |          Owner:  (none)
     Type:  task                                 |         Status:
                                                 |  needs_review
 Priority:  Medium                               |      Milestone:
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  documentation tor-client manpage     |  Actual Points:
  easy 043-can                                   |
Parent ID:  #4310                                |         Points:
 Reviewer:  catalyst                             |        Sponsor:
-------------------------------------------------+-------------------------

Comment (by catalyst):

 Replying to [comment:1 swati]:

 > Created a Pull Request - https://github.com/torproject/tor/pull/1715 for
 the following changes:
 >  - Alphabetized the Server and Directory Server Options

 Thanks!  It looks like MaxOnionQueueDelay is out of order, but the rest of
 Server and Stats options are in order or correctly commented.  I'll check
 the Directory Server options in another comment.

 >  - Created a new section titled **Statistics Options**. Pulled out all
 the stats-related and extra-info related options, and put them into this
 new section.

 Looks good!  I would suggest a few minor changes to the introductory text.
 Change "following options describe" to "following options affect".  Change
 "that Tor collects and writes" to "that Tor relays collect and publish".
 What do you think?

 > Should I pull out the DownloadExtraInfo option (that is presently under
 the Client Options section) and move it under **Statistics Options**?

 I think this still belongs in the Client Options section, because it
 doesn't affect how relays report their statistics.

 Also, I think RephistTrackTime might belong in the stats section, because
 it changes the length of the period that relays use to report their
 bandwidth stats.  (I'm still researching this.  Anyone else have ideas?)

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