<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, May 2, 2018 at 4:56 AM, Iain Learmonth <span dir="ltr"><<a href="mailto:irl@torproject.org" target="_blank">irl@torproject.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi All,<br>
<br>
Looking at the recent work on the Tor bandwidth measurements document<br>
format, I've noticed there are a few places where language can be<br>
ambiguous [0]. This morning, I noticed more ambiguity in some metrics<br>
tools [1]. We could do with a glossary.<br>
<br>
The problem though is not the lack of a glossary, but that we have at<br>
least 3 [2][3][4].<br>
<br>
I've just been discussing this with juga in IRC. For the Metrics<br>
glossary, I think (but please correct me if I'm wrong) that the Metrics<br>
team would be happy to have our glossary's definitions match up with<br>
torspec. I also think it would be cool if we only add new terms to the<br>
Metrics glossary if they have a corresponding term in torspec's glossary.<br>
<br>
Would the torspec maintainers be happy to review and merge patches for<br>
new terms to facilitate that?<br>
<br>
The community glossary is perhaps more broad than the Metrics or torspec<br>
glossaries, and so having all those terms in torspec would probably not<br>
be a useful thing to do.<br>
<br>
Would it be agreeable with the community team that terms that are<br>
already defined in torspec should not be overloaded and that new terms<br>
shouldn't be defined in torspec if they would have conflicting meanings<br>
with terms defined in the community glossary?<br>
<br>
If you have other ideas, then please do also suggest them.<br><br></blockquote><div><br></div><div>In the abstract, I'm generally in favor of using the same terms and vocabulary everywhere.  I guess that there might be specific cases where some term is too entrenched to replace or something, but I bet we can handle that when we come across it.<br><br></div><div>Let's start slow and easy, and work up to the more difficult stuff.<br></div><div><br></div><div>peace,<br></div><div>-- <br></div><div>Nick<br></div></div></div></div>