[metrics-bugs] #28615 [Metrics/Library]: Additional @type annotation

[Tor Bug Tracker & Wiki]

#28615: Additional @type annotation
-----------------------------+------------------------------
 Reporter:  atagar           |          Owner:  metrics-team
     Type:  enhancement      |         Status:  new
 Priority:  Medium           |      Milestone:
Component:  Metrics/Library  |        Version:
 Severity:  Normal           |     Resolution:
 Keywords:                   |  Actual Points:
Parent ID:                   |         Points:
 Reviewer:                   |        Sponsor:
-----------------------------+------------------------------

Comment (by karsten):

 Trying to summarize where we are:

  - We're going to add a new `@type detached-signature 1.0` for: Detached
 signature as per section 3.10 of the dir-spec,  and downloadable for
 DistSeconds every consensus freshness period (usually five minutes each
 hour) via the `/tor/status-vote/next/consensus-signatures` resource.
  - We define `@type network-status-entry-3 1.0` for: Individual router
 status entry obtained from the control port based on a v3 network status
 document. Based on unflavored network status consensus entries, except
 with truncated descriptor digests if tor is using microdescriptors and
 without `w` lines.
  - We drop the plan to add two more types for network/router status
 entries discussed earlier, because the controller wouldn't produce them
 anyway.
  - Finally, we need `@type bandwidth-file 1.2` for: Bandwidth file
 produced by sbws for use by directory authorities acting as bandwidth
 authorities, and downloadable via the `/tor/...` (add URL) resource.

 Does this make sense? atagar, would you mind starting a patch?

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