EBernhardson has uploaded a new change for review.
https://gerrit.wikimedia.org/r/287158
Change subject: Copyediting and instructions improvements
......................................................................
Copyediting and instructions improvements
Change-Id: Id356b36df8d9a711dc010ddc3d656274e3a060e2
---
M views/instructions.twig
M views/layout.twig
M views/splash.twig
3 files changed, 37 insertions(+), 24 deletions(-)
git pull ssh://gerrit.wikimedia.org:29418/wikimedia/discovery/discernatron
refs/changes/58/287158/1
diff --git a/views/instructions.twig b/views/instructions.twig
index 1bd556a..9c13695 100644
--- a/views/instructions.twig
+++ b/views/instructions.twig
@@ -16,38 +16,50 @@
<h3>How do I score queries?</h3>
<p>
You will be presented with a page containing the query at the very
top and a
- list of results that could be relevant to the query. By tapping on
the result
- your relevance ranking will cycle from None to <span
class="irrelevant">
- Irrelevant</span>, <span class="maybe">Maybe Relevant</span>,
<span class="probably">
- Probably Relevant</span>, and <span
class="relevant">Relevant</span>. Tapping
- once more after <span class="relevant">green</span> will bring the
result back
- to unrated. You must rate at least 80% of the results to a query
for the
- results to be saved. If you aren't sure select 'Skip this query'
and you will
- be taken to a new query to rate. Skipped queries will not be shown
to you
- again.
+ list of results that could be relevant to the query. By tapping or
clicking on
+ the result your relevance ranking will cycle from None to <span
+ class="irrelevant"> Irrelevant</span>, <span class="maybe">Maybe
+ Relevant</span>, <span class="probably"> Probably Relevant</span>,
and <span
+ class="relevant">Relevant</span>. Tapping once more after <span
+ class="relevant">green</span> will bring the result back to
unrated. You must
+ rate at least 80% of the results to a query for the results to be
saved. If you
+ aren't sure select 'Skip this query' and you will be taken to a
new query to
+ rate. Skipped queries will not be shown to you again.
+ </p>
+
+ <h3>Snippets</h3>
+ <p>
+ Along with each potential search result there is a snippet
available. Clicking
+ on the down arrow (<span class="glyphicon
glyphicon-chevron-down"></span>) will
+ expand the snippet for a given result.
</p>
<h3>What differentiates Relevant from Probably Relevant?</h3>
<p>
- A result is relevant if you would expect to find it in the top 5
results to a
- query. If something is related and possibly the answer to the
query, but not
- certainly, use it's probably relevant. When grading please keep in
mind that
- the top of results page is limited in space, having 10 results
that are all the
- best answer to a query is impossible to show. Try and pick the
best results as
- relevant, and set the others to probably relevant. Probably
relevant results are
- ones you would expect to find in the bottom two thirds of the
first result page.
+ A result is <span class="relevant">relevant</span> if you would
expect to find
+ it in the top 5 results to a query. If something is related and
possibly the
+ answer to the query, but not certainly, use <span
class="probably">probably
+ relevant</span>. When grading please keep in mind that the top of
results page
+ is limited in space; having 10 results that are all the best
answer to a query
+ is impossible to show. Try and pick the best results as <span
+ class="relevant">relevant</span>, and set the others to <span
+ class="probably">probably relevant</span>. <span
class="probably">Probably
+ relevant</span> results are ones you would expect to find in the
bottom two
+ thirds of the first result page.
</p>
- <h3>Maybe relevant?</h3>
+ <h3>Maybe Relevant?</h3>
<p>
- The maybe relevant ranking is reserved for items that aren't
completely
- irrelevant, but also aren't great answers to the query. Maybe
relevant results
- could show up on the results page, but wouldn't be particularly
desirable. The
- main difference between maybe relevant and irrelevant is that
irrelevant
- queries have no relationship to the query.
+ The <span class="maybe">maybe relevant</span> ranking is reserved
for items
+ that aren't completely irrelevant, but also aren't great answers
to the query.
+ <span class="maybe">Maybe relevant</span> results could show up on
the results
+ page, but wouldn't be particularly desirable. The main difference
between <span
+ class="maybe">maybe relevant</span> and <span
+ class="irrelevant">irrelevant</span> is that <span
+ class="irrelevant">irrelevant</span> queries have no relationship
to the query.
</p>
- <h3>What about disambiguation pages, lists, or categories?</h3>
+ <h3>What about disambiguation pages, lists, talk pages, categories,
etc.?</h3>
<p>
We are not sure yet if these are good results or not. Use your
best judgement
as to the quality of a result with respect to the given query and
we will
diff --git a/views/layout.twig b/views/layout.twig
index 25302f3..c2333a1 100644
--- a/views/layout.twig
+++ b/views/layout.twig
@@ -34,6 +34,7 @@
<a href="#" class="dropdown-toggle"
data-toggle="dropdown" role="button" aria-haspopup="true"
aria-expanded="false">Signed in as {{ user.nickname }}<span
class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="{{ path('random_query')
}}">Score Results</a></li>
+ <li><a href="{{ path('instructions')
}}">Instructions</a></li>
<li><a href="{{ path('import_query')
}}">Import Query</a></li>
<li><a href="{{ path('scores')
}}">Scores</a></li>
<li><a href="{{ path('logout')
}}">Logout</a></li>
diff --git a/views/splash.twig b/views/splash.twig
index fbd3b18..a4efdc5 100644
--- a/views/splash.twig
+++ b/views/splash.twig
@@ -25,7 +25,7 @@
</div>
<div class="container">
<div class="row">
- <h3>What queries am i rating?</h3>
+ <h3>What queries am I rating?</h3>
<p>
Every month the discovery department loads approximately 500
randomly selected search
queries from the English Wikipedia into Discernatron for
grading. These queries
--
To view, visit https://gerrit.wikimedia.org/r/287158
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings
Gerrit-MessageType: newchange
Gerrit-Change-Id: Id356b36df8d9a711dc010ddc3d656274e3a060e2
Gerrit-PatchSet: 1
Gerrit-Project: wikimedia/discovery/discernatron
Gerrit-Branch: master
Gerrit-Owner: EBernhardson <ebernhard...@wikimedia.org>
_______________________________________________
MediaWiki-commits mailing list
MediaWiki-commits@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
