[tor-bugs] #28804 [Core Tor/Tor]: Add circuit padding to padding-spec.txt and write a doc for researchers

[Tor Bug Tracker & Wiki]

#28804: Add circuit padding to padding-spec.txt and write a doc for researchers
-------------------------------------------------+-------------------------
 Reporter:  asn                                  |          Owner:
                                                 |  mikeperry
     Type:  defect                               |         Status:
                                                 |  assigned
 Priority:  High                                 |      Milestone:  Tor:
                                                 |  unspecified
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  wtf-pad, tor-relay, tor-cell,        |  Actual Points:
  padding, tor-spec, 041-proposed, network-      |
  team-roadmap-august, scalability-roadmap       |
Parent ID:                                       |         Points:  2
 Reviewer:  asn                                  |        Sponsor:
                                                 |  Sponsor2
-------------------------------------------------+-------------------------

Comment (by asn):

 Oops I thought this was needs_review so I took a look, but it seems like
 it's not.

 Anyhow, spec patch looks good.

 And also some high-level comments on the developer doc:
 - Let's make it markdown since both github and gitlab support md files
 these days and it seems to be the norm? I doubt researchers appreciate
 text files that much.
 - Let's add a "High-level system overview" section before the "Header
 walkthrough" that explains how this whole system works in two paragraphs
 or so.
 - On the `2. What to consider when creating a new machine`, I'd also like
 an explanation of how machine numbers should work, and how to choose your
 machine number to avoid conflicts with other tor versions etc.
 - Other than that, looks good to me.

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