[metrics-team] How to find metrics code

[Iain Learmonth]

Hi,

On 12/11/18 01:12, teor wrote:
> I found them an easy ticket, which had a copy of the line of code that
> needed to be changed. But it took us about 15 minutes to find that line
> of code.

We are currently working on a few documentation tasks that might help
with this in the future. For now, JavaDoc is available for the projects,
but I don't know if we actually publish it all. Maybe we should do this
with GitHub Pages and Travis.

> We tried searching using GitHub, but the metrics repositories have not
> been mirrored (#28394). I don't think the gitweb.torproject.org search
> covers multiple repositories, and it isn't particularly good inside a
> repository.

I think the GitHub mirroring is fixed now. If it's not, then please let
me know.

> We also tried looking in the reproducible metrics guide, but it doesn't
> link to the relevant source code, or the relevant repositories.

This guide is for people that would want to reimplement the metrics to
reproduce (and so validate) our results. It's actually sort of nice that
we don't link to code here so that anyone following the guide isn't
influenced by any bugs we have, and maybe they are then found.

> When I see something on the metrics website, how do I find the code
> that implements it? Is there some way to make it easier?

For the graphs, look in the metrics-web repository. Setting up a
development environment for this isn't easy, and I've not actually done
it myself yet. This is something that we'd like to fix.

Thanks,
Iain.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <http://lists.torproject.org/pipermail/metrics-team/attachments/20181113/4097b8d9/attachment.sig>