[tor-bugs] #22827 [Core Tor/Tor]: Formalise CollecTor spec for sanitised bridge descriptors and put in torspec

[Tor Bug Tracker & Wiki]

#22827: Formalise CollecTor spec for sanitised bridge descriptors and put in
torspec
---------------------------------------------+-----------------------------
 Reporter:  isis                             |          Owner:  karsten
     Type:  enhancement                      |         Status:
                                             |  needs_review
 Priority:  Medium                           |      Milestone:  Tor:
                                             |  unspecified
Component:  Core Tor/Tor                     |        Version:
 Severity:  Normal                           |     Resolution:
 Keywords:  tor-spec, tor-docs, tor-bridges  |  Actual Points:
Parent ID:                                   |         Points:
 Reviewer:                                   |        Sponsor:
---------------------------------------------+-----------------------------

Comment (by iwakeh):

 Yes, there is some risk of specification sickness :-)

 I added my comments as `cref` elements, which should make easy to spot
 them. I tried to change all references to dir-spec into "Tor directory
 protocol, version 3", removed very few typos, and replaced tabs by spaces.

 The attached xml can be processed into html using xslt; this makes things
 a little prettier and is more adjustable than 'pure' rfc.  The xml almost
 the same, but 'pure' rtf refused to insert the comments into the text and
 didn't allow `eref` tags inside a comment.
 The tools for xslt processing are listed in a comment.  But, no need to
 fiddle with that immediately as I also attached the generated html.

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