Skip to content

Commit

Permalink
Changes to About page, Help page, Index and Registration.
Browse files Browse the repository at this point in the history 
Also, deleted old project instructions from readme.md and added small description of verily.
  • Loading branch information
@larenal
larenal committed Feb 26, 2015
1 parent 7a9f854 commit c885a0d
Show file tree
Hide file tree
Showing 10 changed files with 129 additions and 96 deletions.
68 changes: 3 additions & 65 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,66 +1,4 @@
# Overview
The web service allows questions to be added, updated and removed. Comments can be added to questions for remarks on the content of the question. Answers can be added to questions in response to a question posed. Comments can also be added to answers for remarks on the content of the answer.

Cache validation is supported through the use of ETags on the server-side and the HTTP header "If-None-Match" in client requests to the Web Service.


# Installation
The following steps aim to provide a brief guide on how to set up the web service on Ubuntu Server LTS 12.04.

1. Install Node.js

sudo apt-get update
sudo apt-get install build-essential
sudo apt-get install curl
echo 'export PATH=$HOME/local/bin:$PATH' >> ~/.bashrc
. ~/.bashrc
mkdir ~/local
mkdir ~/node-latest-install
cd ~/node-latest-install
curl http://nodejs.org/dist/node-latest.tar.gz | tar xz --strip-components=1
./configure --prefix=~/local
make install
curl https://npmjs.org/install.sh | sh

2. Install and updated required packages with ```npm update```

# Usage

## Run
To run the server with the existing database use:

```node index```

When the server has started, in a new shell you can issue HTTP requests, via cURL for example.

On the first run, there will be no existing database, so this is equivalent to running from a clean start.

## Run from clean start
To run the server with an empty database use:

```node index -r```

For the first run, the ```-r``` option is not necessary.

# API
For documentation of the API with endpoints and examples, see [```doc/api.html```](doc/api.html) or [```doc/api.md```](doc/api.md).

# Test
To run the system testing script, ensure the web service server is not running, then execute:

```npm test```

This starts the web service server from a clean start and tests questions, question comments, answers and answer comments and the integration of such.

The test script can also be executed in a two-step process with 2 shells:

node index -r
node test

## Shell script
A shell script, ```bin/demo.sh```, provides a series of cURL commands that request each endpoint of the web service.

## JSLint conformance script
To test the conformance of the code to JSLint, run ```bin/jslint-check.sh```.
Before running, ensure you have globally installed JSLint: ```npm install jslint -g```.
# Summary
Verily uses time-critical crowdsourcing to verify information
during major disasters on behalf of humanitarian organizations and media groups worldwide.

11 changes: 11 additions & 0 deletions controllers/crises.js
View file
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,17 @@ exports.help = function (req, res) {
info: req.flash('info'),
error: req.flash('error')
});
};exports.getInvolved = function (req, res) {
res.status(200);
if (req.user){var user = req.user; }
res.render('generic/getInvolved', {
page: {
},
path: '/getInvolved',
user: user,
info: req.flash('info'),
error: req.flash('error')
});
};

var oneCrisisResponse = function(req, res, responseData) {
Expand Down
2 changes: 1 addition & 1 deletion package.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@
"scripts": {
"start": "node index",
"test": "node test-runner",
"postinstall": "./node_modules/component/bin/component install"
"postinstall": "node ./node_modules/component/bin/component install"
},
"engines": {
"node": "0.10.x"
Expand Down
3 changes: 3 additions & 0 deletions routing/routes/crises.js
View file
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,7 @@ exports.route = function (app, controllers, doc) {
route('get', '/challenge', 'challenge', 'Welcome page to the challenge');

route('get', '/help', 'help', 'Get help View');

// Use if it is decided to separate the help link into getInvolved and Guide
//route('get', '/getInvolved', 'getInvolved', 'Get Involved view');
};
Binary file added static/images/world-connections.jpg
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 4 additions & 5 deletions views/generic/about.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ <h2>About</h2>
Verily is an experimental web application designed to rapidly crowdsource the verification of information during humanitarian disasters.
It has been featured in <a href="http://ideas.foreignpolicy.com/posts/2013/05/01/can_critical_thinking_be_crowdsourced">Foreign Policy</a>, <a href="http://www.newscientist.com/article/dn23427-nowhere-to-hide-the-next-manhunt-will-be-crowdsourced.html">New Scientist</a> and <a href="http://www.technologyreview.com/news/514056/preventing-misinformation-from-spreading-through-social-media/">MIT Technology Review</a>, as well as in a
<a href="https://www.youtube.com/watch?v=7eKkquHiFE4&t=10m42s">TedX talk on Digital Humanitarians</a> and the TTI Vanguard presentation below.
The platform has also been piloted by international news organizations. In addition to rapidly verifying information during crisis events, Verily <a href="/help">aims to educate</a> members of the public so they can become better &quot;Digital Detectives&quot;. Simply <a href="/register">sign up here</a> if you want to know when respected humanitarian organizations need help verifying information.
The platform has also been piloted by international news organizations. In addition to rapidly verifying information during crisis events, Verily <a href="/help">aims to educate</a> members of the public so they can become better &quot;Digital Detectives&quot;. Simply <a href="/#email_get_updates">sign up here</a> if you want to know when respected humanitarian organizations need help verifying information.
</div>

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/FPHPi0LYz7o?start=1442&rel=0&amp;showinfo=0" frameborder="0" allowfullscreen></iframe>
Expand All @@ -37,10 +37,8 @@ <h3>Credits</h3>

<h3>Contact</h3>
<div>
For more information about Verily please contact us at <a href="contact@veri.ly">contact@veri.ly</a>
<br/>
Follow us <a href="https://twitter.com/intent/user?screen_name=veridotly">@VeriDotLy</a>
</div>
Be a Digital Detective, <a href="https://groups.google.com/forum/?hl=en#!forum/verily-announces">Join the network</a>
</div>

<h3 id="copyright">Copyright</h3>
<div>
Expand All @@ -57,6 +55,7 @@ <h2>Team</h2>
<li><a href="http://chato.cl/research/">Carlos Castillo</a></li>
<li><a href="http://users.ecs.soton.ac.uk/ec/">Enrico Costanza</a></li>
<li><a href="http://alexgreenland.com/">Alex Greenland</a></li>
<li><a href="https://twitter.com/heatherleson">Heather Leson</a></li>
<li><a href="http://www.juscomms.com/">Justine Mackinnon</a></li>
<li><a href="http://irevolution.net/bio/">Patrick Meier</a></li>
<li><a href="http://users.ecs.soton.ac.uk/vn/">Victor Naroditskiy</a></li>
Expand Down
70 changes: 70 additions & 0 deletions views/generic/getInvolved.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
{% extends '../layout.html' %}

{% set path = '/about' %}

{% block content %}

<div class="team row">

<div class="col-md-8">
<h2>About</h2>
<div>
Verily is an experimental web application designed to rapidly crowdsource the verification of information during humanitarian disasters.
It has been featured in <a href="http://ideas.foreignpolicy.com/posts/2013/05/01/can_critical_thinking_be_crowdsourced">Foreign Policy</a>, <a href="http://www.newscientist.com/article/dn23427-nowhere-to-hide-the-next-manhunt-will-be-crowdsourced.html">New Scientist</a> and <a href="http://www.technologyreview.com/news/514056/preventing-misinformation-from-spreading-through-social-media/">MIT Technology Review</a>, as well as in a
<a href="https://www.youtube.com/watch?v=7eKkquHiFE4&t=10m42s">TedX talk on Digital Humanitarians</a> and the TTI Vanguard presentation below.
The platform has also been piloted by international news organizations. In addition to rapidly verifying information during crisis events, Verily <a href="/help">aims to educate</a> members of the public so they can become better &quot;Digital Detectives&quot;. Simply <a href="/#email_get_updates">sign up here</a> if you want to know when respected humanitarian organizations need help verifying information.
</div>

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/FPHPi0LYz7o?start=1442&rel=0&amp;showinfo=0" frameborder="0" allowfullscreen></iframe>

<h3>Credits</h3>
<div>
Verily was introduced in 2013 in a <a href="http://www2013.org/companion/p1029.pdf">paper</a> by <a href="http://chato.cl/research/">Carlos Castillo</a> (<a href="http://www.qcri.qa/page?a=103&lang=en-CA">QCRI</a>), <a href="http://irevolution.net/bio/">Patrick Meier</a> (<a href="http://www.qcri.qa/page?a=103&lang=en-CA">QCRI</a>), <a href="http://users.ecs.soton.ac.uk/vn/">Victor Naroditskiy</a> (<a href="http://www.aic.ecs.soton.ac.uk/">Southampton</a>) and <a href="http://www.mit.edu/~irahwan/">Iyad Rahwan</a> (<a href="http://www.masdar.ae/en/">Masdar</a>).
A proof-of-concept was developed that year by Dmytro Krasnoshtan, Attila-Peter Toth, and Abdulfatai Popoola.
</div>

<div>
Design and development of the actual platform started in 2014 spearheaded by <a href="http://users.ecs.soton.ac.uk/ec/">Enrico Costanza</a> and <a href="http://users.ecs.soton.ac.uk/vn/">Victor Naroditskiy</a> at the University of Southampton, thanks to the enthusiasm, technical expertise and relentless work of <a href="http://uk.linkedin.com/pub/luis-arenal/46/778/684/de">Luis Arenal Mijares</a>, <a href="http://alexgreenland.com/">Alex Greenland</a> and <a href="http://gr.linkedin.com/pub/dimitrios-papamilios/70/510/33b">Dimitrios Papamilios</a>, who at the time were students of the <a href="http://www.ecs.soton.ac.uk/programmes/msc-web-technology">Web Technology MSc programme</a>.
</div>

<div>
In July 2014 we ran the first public trial of Verily, thanks to the effort of <a href="http://www.juscomms.com/">Justine Mackinnon</a> (<a href="http://www.qcri.qa/page?a=103&lang=en-CA">QCRI</a>).
</div>

<div>
Verily is supported, in part, by the <a href="http://www.orchid.ac.uk">ORCHID</a> project.
</div>

<h3>Contact</h3>
<div>
For more information about Verily please contact us at <a href="contact@veri.ly">contact@veri.ly</a>
<br/>
Follow us <a href="https://twitter.com/intent/user?screen_name=veridotly">@VeriDotLy</a>
</div>

<h3 id="copyright">Copyright</h3>
<div>
&copy; 2014 Verily team. Source code is <a href="https://github.com/verily-org/verily/blob/master/LICENSE">MIT-licensed</a>, available on <a href="https://github.com/verily-org/verily">GitHub</a>.
User-contributed submissions are licensed with the <a href="https://creativecommons.org/licenses/by/3.0/">CC-BY-3.0 licence</a>.
</div>

</div>

<div class="col-md-4">
<h2>Team</h2>
<ul class="no-bullets">
<li><a href="http://uk.linkedin.com/pub/luis-arenal/46/778/684/de">Luis Arenal Mijares</a></li>
<li><a href="http://chato.cl/research/">Carlos Castillo</a></li>
<li><a href="http://users.ecs.soton.ac.uk/ec/">Enrico Costanza</a></li>
<li><a href="http://alexgreenland.com/">Alex Greenland</a></li>
<li><a href="http://www.juscomms.com/">Justine Mackinnon</a></li>
<li><a href="http://irevolution.net/bio/">Patrick Meier</a></li>
<li><a href="http://users.ecs.soton.ac.uk/vn/">Victor Naroditskiy</a></li>
<li><a href="http://gr.linkedin.com/pub/dimitrios-papamilios/70/510/33b">Dimitrios Papamilios</a></li>
<li><a href="http://www.mit.edu/~irahwan/">Iyad Rahwan</a></li>
</ul>
</div>

</div>

{% endblock %}
30 changes: 17 additions & 13 deletions views/generic/help.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,17 @@
<div class="row">
<div class="col-md-8">
<h2>How to Become a Digital Detective</h2>
<p>
The <a href="#toc">short guides below</a> provide guidance on how to verify digital content.
These guides are taken from the expert advice published in the highly respected
<a href="http://www.google.com/url?q=http%3A%2F%2Fverificationhandbook.com%2Fdownloads%2Fverification.handbook.pdf&sa=D&sntz=1&usg=AFQjCNE04lVA1iSnk_3Y3Y1zjnCdQfBsQg">Verification Handbook</a>.
The guides will quickly give you the skills and knowledge you need to become a first rate Digital Detective.
</p>
<h2>Got feedback?</h2>
<h2>Found a bug?</h2>
<h3>Please let us know!</h3>
<h4>Verily is all about people participation, get involved in any of these ways:</h4>
<div style="margin-left:10px">
<p>On social networks, Follow us <a target="_blank" href="https://twitter.com/VeriDotLy">@VeriDotLy</a> or <a target="_blank" href="https://www.facebook.com/VeriDotLy" >Facebook</a></p>
<p>Join our <a target="_blank" href="https://groups.google.com/forum/?hl=en#!forum/verily-announces">Discussion group</a>.</p>
<p>You like coding? Get involved in <a target="_blank" href="https://github.com/verily-org/verily">Github</a>.</p>
<p>Got Feedback? Found a bug? Help us filling our <a target="_blank" href="http://bit.ly/Verilyfeedback">Form</a>.</p>
<p>Fill that you could use verily to verify? <a target="_blank" href="http://bit.ly/activateverily">Activate Verily</a>.</p>
<p>Simply email us to contact@veri.ly.</p>

</div>
<!--
<div class="row">
<div class="container">
<div class="action-button-ctr btn-group">
Expand All @@ -31,15 +33,17 @@ <h3>Please let us know!</h3>
</div>
</div>
</div>
-->

<div class="row">
<div class="">
<div >

<br/>
<br/>

<p>
This page provides a number of short guides on how to verify digital content. This advice is based on chapters 9 and 10 of the <a href="http://verificationhandbook.com/downloads/verification.handbook.pdf">Verification Handbook</a>
These <a href="#toc">short guides below</a> provide guidance on how to verify digital content.
These guides are taken from the expert advice published in the highly respected
<a target="_blank" href="http://verificationhandbook.com/downloads/verification.handbook.pdf#page=97">Verification Handbook</a> Chapter 9 and 10.
The guides will quickly give you the skills and knowledge you need to become a first rate Digital Detective.
</p>

<h3 id="toc">Digital Detective Guides</h3>
Expand Down
30 changes: 19 additions & 11 deletions views/generic/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,35 +16,46 @@

<div class="welcome">

<div class="well well-sm transparent cookie-message {% if cookieMessageSeen === true %}hidden{% endif %}">
<!-- <div class="well well-sm transparent cookie-message {% if cookieMessageSeen === true %}hidden{% endif %}">
This website is part of an academic research project at the University of Southampton (Ethics
reference number: ERGO/FPSE/10709) and we use cookies to collect information about your activity
on the website (e.g. which pages you visit). If you continue without changing your settings, we'll assume
that you are happy to receive all cookies on the website and you accept the <a href="/terms" target="_blank">Terms and Conditions</a>.
However, if you would like to, you can change your cookie
settings at any time. <a href="http://www.southampton.ac.uk/inf/cookies.html">More information about cookies</a>.
</div>
</div> -->

<h2 class="text-center text-bold">
<strong>Crowdsourced evidence collection and verification for crisis response</strong>
</h2>

<p class="lead stay-large challenge-description text-center">
We live in the Information Age... or the Disinformation Age.
<br>
Finding out the truth in the vast amount of contradictory information is becoming increasingly difficult for everyone.
We live in the Information Age... or the Disinformation Age.
<br>
Finding out the truth in the vast amount of contradictory information is becoming increasingly
difficult for everyone. Verily uses time-critical crowdsourcing to verify information
during major disasters on behalf of humanitarian organizations and media groups worldwide.
<br><br>
Learn more about how Verily works <a href="/about">here</a>.
</p>

<img style=" border-radius: 80px;" src="/static/images/world-connections.jpg"class="img-responsive center-block" />

<h3 class="text-center text-bold"><strong>Please <a target="_blank" href="https://docs.google.com/forms/d/1pJ50nJ4mSi2QU-d_kOhHPk42uJsV32H3uUoA_4DCQSQ/viewform">Click Here</a> to Activate Verily</strong></h3>
<div class="signup-form-for-updates">
<form role="form" action="/subscriber" method="POST">
<input type="hidden" name="_csrf" value="{{csrf_token}}" />
<input type="email" class="form-control input-lg" name="email" placeholder="Email" required>
<!--
The id email_get_updates is used to get focus on it on page load.
To use it, add #email_get_updates at the end of the URL.
-->
<input id="email_get_updates" type="email" class="form-control input-lg" name="email" placeholder="Email" required>
<button type="submit" class="btn btn-primary btn-lg btn-block">Get updates</button>
</form>
</div>



<!--
<div class="well transparent challenge-info-box">
<h2>
#VerilyLive <span id="challenge-countdown"></span>
Expand Down Expand Up @@ -102,11 +113,8 @@ <h2>
</div>
</div>
-->





</div>

<script src="/static/js/moment.js"></script>
Expand Down
2 changes: 1 addition & 1 deletion views/user/register.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
<br>
<div id="form-reg" class="form">
<p class="lead">
Signup with email to know when humanitarian organizations need help
Signup with email
</p>
{% include '../generic/form-signup.html' %}

Expand Down

0 comments on commit c885a0d

Please sign in to comment.