[tor-commits] [metrics-web/master] Document four version-related Onionoo changes.

[karsten at torproject.org]

commit 813e06853812cc35213c444d1794f80430932338
Author: Karsten Loesing <karsten.loesing at gmx.net>
Date:   Sat Nov 18 21:27:32 2017 +0100

    Document four version-related Onionoo changes.
    
    This update covers four Onionoo changes that are all related to
    versions and recommended versions: #22488, #23962, #21827, and #23544.
---
 website/src/main/resources/web/WEB-INF/onionoo.jsp | 74 +++++++++++++++++++++-
 1 file changed, 72 insertions(+), 2 deletions(-)

diff --git a/website/src/main/resources/web/WEB-INF/onionoo.jsp b/website/src/main/resources/web/WEB-INF/onionoo.jsp
index 3e73fa7..8f9bfad 100644
--- a/website/src/main/resources/web/WEB-INF/onionoo.jsp
+++ b/website/src/main/resources/web/WEB-INF/onionoo.jsp
@@ -284,6 +284,13 @@ Added a new "host_name" parameter to filter by host name and a new
 "unreachable_or_addresses" field with declared but unreachable OR
 addresses on November 17, 2017.
 <a href="#versions_4_3" class="anchor">#</a></li>
+<li><a id="versions_4_4"></a><strong>4.4</strong>:
+Extended the "version" parameter to bridges, added a
+"recommended_version" parameter for relays and bridges, added a
+"version" field to relay and bridge details documents, and added a
+"recommended_version" field to bridge details documents on November
+28, 2017.
+<a href="#versions_4_4" class="anchor">#</a></li>
 <li><a id="versions_5_0"></a><strong>5.0</strong>
 (scheduled, but not deployed yet!): Remove $ from fingerprints in
 "effective_family", "alleged_family", and "indirect_family" fields, to
@@ -563,12 +570,13 @@ a family.
 
 <li>
 <a id="parameters_version"></a>
-<b>version</b>
+<b>version <span class="label label-primary">updated</span></b>
 <a href="#parameters_version" class="anchor">#</a>
 <p>
-Return only relays running a Tor version that starts with the
+Return only relays or bridges running a Tor version that starts with the
 parameter value <i>without</i> leading <code>"Tor"</code>.
 Searches are case-insensitive.
+<span class="blue">Extended to bridges on November 28, 2017.</span>
 </p>
 </li>
 
@@ -587,6 +595,21 @@ Filtering by host name is case-insensitive.
 </p>
 </li>
 
+<li>
+<a id="parameters_recommended_version"></a>
+<b>recommended_version <span class="label label-primary">new</span></b>
+<a href="#parameters_recommended_version" class="anchor">#</a>
+<p>
+Return only relays and bridges running a Tor software version that is
+recommended (parameter value <strong>true</strong>) or not recommended by
+the directory authorities (parameter value <strong>false</strong>).
+Relays and bridges are not contained in either result, if the version they
+are running is not known.
+Parameter values are case-insensitive.
+<span class="blue">Added on November 28, 2017.</span>
+</p>
+</li>
+
 </ul>
 
 <p>
@@ -1431,6 +1454,22 @@ found.
 </li>
 
 <li>
+<a id="details_relay_version"></a>
+<b>version <span class="label label-primary">new</span></b>
+<code class="typeof">string</code>
+<span class="required-false">optional</span>
+<a href="#details_relay_version" class="anchor">#</a>
+<p>
+Tor software version <i>without</i> leading <code>"Tor"</code> as reported
+by the directory authorities in the "v" line of the consensus.
+Omitted if either the directory authorities or the relay did not report
+which version the relay runs or if the relay runs an alternative Tor
+implementation.
+<span class="blue">Added on November 28, 2017.</span>
+</p>
+</li>
+
+<li>
 <a id="details_relay_recommended_version"></a>
 <b>recommended_version</b>
 <code class="typeof">boolean</code>
@@ -1763,6 +1802,37 @@ information cannot be found.
 </li>
 
 <li>
+<a id="details_bridge_version"></a>
+<b>version <span class="label label-primary">new</span></b>
+<code class="typeof">string</code>
+<span class="required-false">optional</span>
+<a href="#details_bridge_version" class="anchor">#</a>
+<p>
+Tor software version <i>without</i> leading <code>"Tor"</code> as reported
+by the bridge in the "platform" line of its server descriptor.
+Omitted if not provided by the bridge, if the descriptor containing this
+information cannot be found, or if the bridge runs an alternative Tor
+implementation.
+<span class="blue">Added on November 28, 2017.</span>
+</p>
+</li>
+
+<li>
+<a id="details_bridge_recommended_version"></a>
+<b>recommended_version <span class="label label-primary">new</span></b>
+<code class="typeof">boolean</code>
+<span class="required-false">optional</span>
+<a href="#details_bridge_recommended_version" class="anchor">#</a>
+<p>
+Boolean field saying whether the Tor software version of this bridge is
+recommended by the directory authorities or not.
+Omitted if either the directory authorities did not recommend versions, or
+the bridge did not report which version it runs.
+<span class="blue">Added on November 28, 2017.</span>
+</p>
+</li>
+
+<li>
 <a id="details_bridge_transports"></a>
 <b>transports</b>
 <code class="typeof">array of strings</code>