1341818 - Write a guide to collecting new data

Status: RESOLVED FIXED

(Data Platform and Tools :: Documentation and Knowledge Repo (RTMO), defect, P1)

Description

[Ryan Harter [:harter]]

This may be covered by the adding new pings [0] and adding new probes [1] documents, but we should have pointers to this documentation in the Comprehensive Data Docs.

[0] https://docs.google.com/document/d/11wM2RJkHAqYF-4xgL5tHwA621IUQEaf4vecuC-hqnzk/edit#
[1] https://developer.mozilla.org/en-US/docs/Mozilla/Performance/Adding_a_new_Telemetry_probe

Comment 1

[Georg Fritzsche [:gfritzsche]]

I expect that bug 1276201 will be good preparation for that.
I think that has mostly the same goals, but should go live soon.

Comment 2

[Georg Fritzsche [:gfritzsche]]

Ryan, i rewrote the wiki page [0].
Is that the style you are looking for?
Are there any obvious gaps in coverage?

Commenting may be easier in [1].

0: https://developer.mozilla.org/en-US/docs/Mozilla/Performance/Adding_a_new_Telemetry_probe
1: https://docs.google.com/document/d/183G5wZC2waNxBxdx6TK8f2o3fs0msuPpfafYC7lYhQs/edit#heading=h.yhrtgoe7tyo4

Comment 3

[Ryan Harter [:harter]]

Thanks, Georg, this looks great to me! I was planning on having an article on this in the gitbook [0] but now I'm thinking we should just link to your article. Do you have an opinion? 

[0] https://github.com/mozilla/firefox-data-docs

Comment 4

[Georg Fritzsche [:gfritzsche]]

I'm an undecided as well.
Maybe we could start with the link to the article.
Then, based on feedback etc., we can decide whether we need to change this?

Comment 5

[Ryan Harter [:harter]]

SGTM!

Comment 6

[Georg Fritzsche [:gfritzsche]]

Do you want to add the linking as part of this bug?

Comment 7

[Ryan Harter [:harter]]

Finally added that link today.
https://mozilla.github.io/firefox-data-docs/datasets/new_data.html