[tor-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_revision
 Priority:  Medium           |      Milestone:
Component:  Metrics/Website  |        Version:
 Severity:  Normal           |     Resolution:
 Keywords:  metrics-2018     |  Actual Points:
Parent ID:                   |         Points:  2
 Reviewer:  iwakeh, karsten  |        Sponsor:
-----------------------------+--------------------------------
Changes (by karsten):

 * status:  needs_review => needs_revision


Comment:

 I reviewed the branch and built it locally. Some thoughts:
  - The text really reads well! In the first pass I didn't spot anything
 incorrect or misleading. Great stuff!
  - When looking at the locally built website, I noticed that the home page
 now starts with a lot of text. This might be a bit intimidating for new
 users and slightly annoying for returning users. Don't get me wrong, the
 text is useful, it's the presentation that we might still be able to
 improve. Maybe split up paragraphs and use paragraph titles?
  - Related to the point above, the two columns on the start page should
 have the same length.
  - You're saying "Tor Metrics Portal" in at least one place, but I think
 we stopped calling it a portal a while ago. We're referring to the website
 as "Tor Metrics" or "Tor Metrics website".
  - The descriptions under Philosophy look a bit like they could benefit
 from some more whitespace. I guess we did not style them when we redid the
 website last year, because we didn't use description lists before. Maybe
 we should just add a little bit of space before the `<dt>` part? We could
 ask antonela.
  - The dependencies diagram on the About page is really neat! Are there
 instructions anywhere how I would build that?
  - That diagram should also include Consensus Health, which fetches data
 from the directory authorities without help of metrics-lib, and which we
 could say is made for users, not primarily researchers or developers.

 All in all, I really like what you wrote there! Let's see if we can tweak
 it some more, and let's also hear what iwakeh has to add. Maybe we can
 even deploy this in the next days.

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