[tor-bugs] #29315 [Metrics/Website]: Write down guidelines for adding new stats

[Tor Bug Tracker & Wiki]

#29315: Write down guidelines for adding new stats
-----------------------------+------------------------------
 Reporter:  karsten          |          Owner:  karsten
     Type:  enhancement      |         Status:  needs_review
 Priority:  Medium           |      Milestone:
Component:  Metrics/Website  |        Version:
 Severity:  Normal           |     Resolution:
 Keywords:                   |  Actual Points:
Parent ID:                   |         Points:  3
 Reviewer:                   |        Sponsor:
-----------------------------+------------------------------

Comment (by juga):

 Replying to [comment:3 karsten]:
 [...]
 > > Nitpick: "your data", i never thought i was asking metrics to publish
 "my data" but rather Tor network data.
 >
 > Ah, interesting point.
 >
 > The reason why the document says "you" and "me" is that it's basically
 the transcription of an imaginary conversation I had with dgoulet or ahf
 or teor or you. And of course I didn't mean "your data" as in "juga's
 data", but I think you didn't mean that either.
 >
 > The decision how to refer to the tool providing data is an important
 one. I wanted to make clear that Tor Metrics does not suddenly become the
 owner of the tool, neither with respect to its code nor to its operation,
 not even of the part that exports data to Tor Metrics. There must be a
 clear interface, and the owner of the tool providing the data will always
 stay in charge of the parts beyond that interface from a Tor Metrics point
 of view. It's not that Tor network data magically lands on Tor Metrics and
 nobody feels responsible anymore. I think I implicitly wanted to make that
 clear by using "you" and "we" in the document.

 That makes sense. I also think that the conversation style probably makes
 it easier to read.

 > I'm open to different suggestions, though. This is just the very first
 draft, and we'll improve it as we add more of ''"your"'' Tor network data
 to Tor Metrics. :)

 :)
 Certainly seems hard to come up with an alternative without making the
 style more impersonal or using longer sentences.
 I can only come now with adding a note after the the first "your data"
 something like:
 "[*] by your data we don't mean the data belongs to you, but you're one of
 the persons working on the source that produces the data."
 Still fine if you leave it without any note.

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