[metrics-bugs] #23169 [Metrics/Website]: Explain why metrics are important and what we do to make sure they're safe

[Tor Bug Tracker & Wiki]

#23169: Explain why metrics are important and what we do to make sure they're safe
-----------------------------+------------------------------
 Reporter:  arma             |          Owner:  irl
     Type:  defect           |         Status:  needs_review
 Priority:  Medium           |      Milestone:
Component:  Metrics/Website  |        Version:
 Severity:  Normal           |     Resolution:
 Keywords:  metrics-2018     |  Actual Points:
Parent ID:                   |         Points:  2
 Reviewer:  iwakeh, karsten  |        Sponsor:
-----------------------------+------------------------------

Comment (by iwakeh):

 Yes, this is a nice Metrics-About page!

 Some remarks/questions:
 The dot file should not be in the 'web/images' folder as it is only the
 source for the png.  The png should always be committed (same process as
 with our generated spec jsps, for example), because these depend on the
 dot implementation used.  Even with a future Ant task at hand that limits
 dependencies for building the war file.  Regarding dot file location: what
 about `src/main/resources/doc/ecosystem.dot` or
 `src/main/resources/doc/ecosystem/ecosystem.dot`?

 A second thought about this graph, which I like and understand, but it
 might cause confusion for the 'uninitiated' as it is not really described
 fully.  And, the metrics-lib oval is kind of dangling in the air and the
 "via metrics-lib" label used three times.  I first thought of making it a
 different shape (see attachment),
 [[Image(https://trac.torproject.org/projects/tor/attachment/ticket/23169
 /another-overview.png)]]
 but then noticed that this also is not at all self-explanatory.  So, maybe
 leave the picture out unless we describe the graph a little more?

 Should we think about removing Schneier's quote from the header now (as
 was requested before)?
 It's on the about page now.

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