[tor-bugs] #32708 [Core Tor/Tor]: manpage: alphabetize General Options

[Tor Bug Tracker & Wiki]

#32708: manpage: alphabetize General Options
-------------------------------------------------+-------------------------
 Reporter:  catalyst                             |          Owner:
                                                 |  catalyst
     Type:  task                                 |         Status:
                                                 |  needs_revision
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  0.4.3.x-final
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  documentation tor-client manpage     |  Actual Points:
  easy gsod                                      |
Parent ID:  #4310                                |         Points:  1
 Reviewer:  teor                                 |        Sponsor:
-------------------------------------------------+-------------------------

Comment (by arma):

 Replying to [comment:6 catalyst]:
 > It seems odd to put Password in front of Username, so maybe this can
 also deviate from strict alphabetical order?

 I agree that we shouldn't stick to alphabetical when it makes things
 worse.

 It also seems really easy to just accumulate more items in the future and
 have it all go messy again.

 Maybe that argues for grouping config options by topic? Or for having more
 'areas', where each area is small and alphabetized? Or for writing down
 some heuristics for how we picked the current order, so that when we add
 things in the future we can have a prayer of keeping things organized?

 I don't have any good answers. So I am just here to say that even though I
 wrote 'alphabetized' in a trac ticket eight years ago does not mean that I
 am certain it is the best way to go. :)

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