This is an automated email from the ASF dual-hosted git repository.
gstein pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/steve.git
The following commit(s) were added to refs/heads/trunk by this push:
new 5a6f051 Copy over content from old steve.a.o site.
5a6f051 is described below
commit 5a6f051957545559d5bb64b5a498a0c4f1cd7a74
Author: Greg Stein <[email protected]>
AuthorDate: Tue Apr 5 03:13:10 2022 -0500
Copy over content from old steve.a.o site.
This is a direct copy of:
https://svn.apache.org/repos/asf/steve/site/trunk/content
Revision: 1899543
Omitted the sitemap.* files, and the previously-copied support.mdtext.
No changes made; that is a future step to align the content into the
new pelican-based publishing system.
---
site/pages/demo.html | 42 ++++++++++++++++++++++++++++
site/pages/dev/index.html | 2 ++
site/pages/dev/source-code.mdtext | 46 +++++++++++++++++++++++++++++++
site/pages/documentation.mdtext | 5 ++++
site/pages/downloads.html | 24 ++++++++++++++++
site/pages/index.html | 34 +++++++++++++++++++++++
site/pages/privacy-policy.html | 20 ++++++++++++++
site/pages/vote_types.html | 58 +++++++++++++++++++++++++++++++++++++++
8 files changed, 231 insertions(+)
diff --git a/site/pages/demo.html b/site/pages/demo.html
new file mode 100644
index 0000000..83b0a1c
--- /dev/null
+++ b/site/pages/demo.html
@@ -0,0 +1,42 @@
+{% extends "skeleton.html" %}
+
+{% block title %}Apache STeVe{% endblock %}
+{% block content %}
+
+ <h1>Apache STeVe quickstart guide</h1>
+
+ <h2>pySTeVe</h2>
+
+ <h3>Quickstart Guide</h3>
+ <ul style="font-family: monospace;">
+ <li>svn co
https://svn.apache.org/repos/asf/steve/trunk/pysteve/</li>
+ <li>Edit steve.cfg to suit your needs (karma, DB backend
etc)<br/>
+ IF you choose ElasticSearch as backend, install the
python module (pip install elasticsearch)<br/>
+ OR IF you choose files as your backend, run setup.py in
the CLI directory.
+ </li>
+ <li>Edit httpd.conf, add it to your existing httpd
configuration</li>
+ <li>Set up authorization using htpasswd for admins, monitors
etc</li>
+ <li>Go to http://steve.yourdomain.foo/admin and set up an
election</li>
+ <li>Start voting!</li>
+ </ul>
+<h3>Building a Docker image</h3>
+ <p>
+ You can also build pySTeVe as a Docker image using the Dockerfile
locate in the <kbd>docker</kbd> directory:
+ <ul>
+ <li><kbd>svn co
https://svn.apache.org/repos/asf/steve/trunk/pysteve/</kbd></li>
+ <li><kbd>docker build -t pysteve docker/</kbd></li>
+ <li><kbd>docker run -i -p 127.0.0.1:80:80 pysteve</kbd></li>
+ <li>Navigate to http://localhost/admin to set up stuff, using
the default credentials (admin/admin1234)</li>
+ </ul>
+</p>
+ <!--
+ <h3>Online demonstration</h3>
+ <p>
+ If you'd rather try out STeVe before you install it, we have a
free-to-try demo online.
+ Simple hop on over to <a
href="http://demo.stv.website/";>http://demo.stv.website/</a>
+ and mangle it to your hearts content. All data in the demo is
wiped once a week.
+ Use the username <kbd>admin</kbd> and password <kbd>demo</kbd>
to access the admin area.
+ </p>
+ -->
+
+{% endblock %}
diff --git a/site/pages/dev/index.html b/site/pages/dev/index.html
new file mode 100644
index 0000000..3111321
--- /dev/null
+++ b/site/pages/dev/index.html
@@ -0,0 +1,2 @@
+ <meta http-equiv="refresh" content="0;URL='source-code.html'" />
+
\ No newline at end of file
diff --git a/site/pages/dev/source-code.mdtext
b/site/pages/dev/source-code.mdtext
new file mode 100644
index 0000000..3c3097a
--- /dev/null
+++ b/site/pages/dev/source-code.mdtext
@@ -0,0 +1,46 @@
+Title: Source Code
+
+## pySTeVe
+PySTeVe can be browsed via the [web
interface](https://svn.apache.org/viewvc/steve/trunk/pysteve/).
+
+You can check out the source code at:
[https://svn.apache.org/repos/asf/steve/trunk/pysteve/](https://svn.apache.org/repos/asf/steve/trunk/pysteve/):
+
+
+ $svn co https://svn.apache.org/repos/asf/steve/trunk/pysteve/
+
+
+PySTeVe requires no building/compiling, but does require a setup, as explained
on the [try it out](/demo.html) page.
+
+
+
+
+## Older sources
+You can browse the source code via the [web
interface](http://svn.apache.org/viewvc/steve/trunk/)
+.
+
+You can download (aka checkout) the sources of Apache STeVe with
+Subversion client using the following URL
[http://svn.apache.org/repos/asf/steve/trunk](http://svn.apache.org/repos/asf/steve/trunk)
+.
+
+Performing the checkout from the command line using the subversion client
+is as easy as executing the following command:
+> $ svn co
[http://svn.apache.org/repos/asf/steve/trunk](http://svn.apache.org/repos/asf/steve/trunk)
+
+If you are experiencing problems with errors like "400 Bad Request
+(http://svn.apache.org)", try using:
+> $ svn co
[https://svn.apache.org/repos/asf/steve/trunk](https://svn.apache.org/repos/asf/steve/trunk)
+
+<a name="SourceCode-Continuousintegration"></a>
+# Continuous integration
+
+Apache STeVe continuous integration relies on [Apache
Buildbot](http://ci.apache.org/).
+All builders are available [from the page](http://ci.apache.org/builders).
+
+* [Apache STeVe under Ubuntu](http://ci.apache.org/builders/steve-trunk-ubuntu)
+* [Apache STeVe under Windows](http://ci.apache.org/builders/steve-trunk-win)
+
+<a name="SourceCode-Building"></a>
+# Building
+
+*TODO fill in*
+
diff --git a/site/pages/documentation.mdtext b/site/pages/documentation.mdtext
new file mode 100644
index 0000000..fb15f7e
--- /dev/null
+++ b/site/pages/documentation.mdtext
@@ -0,0 +1,5 @@
+Title: Index
+
+- Wiki - [http://wiki.apache.org/Steve/](http://wiki.apache.org/Steve/)
+- [List of implemented vote types](vote_types.html)
+- [Getting started with pySTeVe](demo.html)
diff --git a/site/pages/downloads.html b/site/pages/downloads.html
new file mode 100644
index 0000000..ccfa862
--- /dev/null
+++ b/site/pages/downloads.html
@@ -0,0 +1,24 @@
+{% extends "skeleton.html" %}
+
+{% block title %}Apache STeVe{% endblock %}
+{% block content %}
+<section xmlns="http://www.w3.org/1999/html";>
+
+ <div class="alert-message">
+ <strong>Feedback Welcome!</strong>
+ We use your feedback to focus efforts, develop new features, and to
make Apache STeVe better for everyone.
+ <a href="mailto:[email protected]?subject=Feedback on Apache
STeVe&body=We'd%20like%20to%20hear%20about%20anything%20you'd%20like%20to%20tell%20us.%20%20If%20you're%20short%20on%20ideas%2C%20here%20are%20some%3A%0A%0A%20-%20Ways%20we%20can%20speed%20up%20or%20improve%20your%20ability%20to%20evaluate%20STeVe%0A%20-%20Anything%20you%20found%20difficult%20or%20inconvenient%20about%20using%20STeVe%0A%20-%20Documentation%20you%20would%20like%20to%20see%0A%20-%20Features%20you%20wou
[...]
+ </div>
+
+ <div>
+ <p>Check out the <a
href="https://svn.apache.org/viewvc/steve/";>SVN repo</a></p>
+ <!-- <p>See also <a href="download/index.html">all previous releases
and current snapshot builds</a></p> -->
+ </div>
+ <div class="page-header">
+ <h1>Apache STeVe
+ <small>no releases yet</small>
+ </h1>
+ </div>
+</section>
+
+{% endblock %}
diff --git a/site/pages/index.html b/site/pages/index.html
new file mode 100644
index 0000000..adfad35
--- /dev/null
+++ b/site/pages/index.html
@@ -0,0 +1,34 @@
+{% extends "skeleton.html" %}
+
+{% block title %}Apache STeVe{% endblock %}
+{% block content %}
+ <div class="jumbotron">
+ <p style="text-align: center; margin-bottom: 20px;">
+ <img src="/images/steve.png"/>
+ </p>
+ <p>Apache STeVe is Apache's Python based voting system that the
Foundation uses to handle things like <a
href="https://wiki.apache.org/general/BoardVoting";>voting in our new Board of
Directors</a>.</p>
+ </div>
+ <div class="row">
+ <p>Apache STeVe supports many types of voting, including (but
not limited to):
+ <ul class="list-group">
+ <li class="list-group-item"><a
href="vote_types.html#stv">Single Transferable Votes</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#yna">Single-motion voting (Yes/No/Abstain)</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#dh">D'Hondt (Jefferson) style voting</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#mntv">Multiple Non-Transferable Votes</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#fpp">First Past the Post (presidential elections)</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#cop">Candidate or Party voting with preferential
trickle-down</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#fic">First in Class (N-x-points based voting)</a></li>
+ <li class="list-group-item"><a
href="vote_types.html#ap">Apache-style Single-motion Voting</a></li>
+ </ul>
+ </p>
+ <p>
+ It also supports multiple database backends:
+ <ul class="list-group">
+ <li class="list-group-item">File-based</li>
+ <li class="list-group-item">ElasticSearch</li>
+ <li class="list-group-item">More to come...</li>
+ </ul>
+ </p>
+
+ </div>
+{% endblock %}
diff --git a/site/pages/privacy-policy.html b/site/pages/privacy-policy.html
new file mode 100644
index 0000000..556b8c7
--- /dev/null
+++ b/site/pages/privacy-policy.html
@@ -0,0 +1,20 @@
+{% extends "skeleton.html" %}
+
+{% block title %}Privacy Policy{% endblock %}
+{% block content %}
+<div class="row">
+ <h1>Privacy Policy</h1>
+ <p>Information about your use of this website is collected using server
access logs and a tracking cookie. The collected information consists of the
following:</p>
+ <ol>
+ <li>The IP address from which you access the website;</li>
+ <li>The type of browser and operating system you use to access our
site;</li>
+ <li>The date and time you access our site;</li>
+ <li>The pages you visit; and</li>
+ <li>The addresses of pages from where you followed a link to our site.</li>
+ </ol>
+ <p>Part of this information is gathered using a tracking cookie set by the
<a href="http://www.google.com/analytics/";>Google Analytics</a> service and
handled by Google as described in their <a
href="http://www.google.com/policies/privacy/";>privacy policy</a>. See your
browser documentation for instructions on how to disable the cookie if you
prefer not to share this data with Google.
+ We use the gathered information to help us make our site more useful to
visitors and to better understand how and when our site is used. We do not
track or collect personally identifiable information or associate gathered data
with any personally identifying information from other sources.</p>
+
+ <p>By using this website, you consent to the collection of this data in the
manner and for the purpose described above.</p>
+</div>
+{% endblock %}
diff --git a/site/pages/vote_types.html b/site/pages/vote_types.html
new file mode 100644
index 0000000..162a6cc
--- /dev/null
+++ b/site/pages/vote_types.html
@@ -0,0 +1,58 @@
+{% extends "skeleton.html" %}
+
+{% block title %}Apache STeVe{% endblock %}
+{% block content %}
+
+ <h1>Apache STeVe Vote Types</h1>
+<br/><hr/>
+<h2 id="yna">Single motion voting (Yes/No/Abstain)</h2>
+<p>
+ This is a simple tally vote. Voters can vote either Yes or No on an
issue, or they can abstain.
+ Votes are tallied, and the result is presented. It is up to the
election committee to interpret the result.
+</p>
+
+<br/><hr/>
+<h2 id="ap">Apache-style Single motion voting (Yes/No/Abstain with binding
votes)</h2>
+<p>
+ This is a simple tally vote. Voters can vote either Yes or No on an
issue, or they can abstain, however
+ certain people (committee members, for instance) may cast binding votes
whereas others may only cast non-binding votes.
+ Votes are tallied, and the result is presented. It is up to the
election committee to interpret the result.
+</p>
+
+
+<br/><hr/>
+<h2 id="fpp">First Past the Post (presidential election style)</h2>
+<p>
+ FPP is a voting system with multiple candidates. The candidate with the
most votes will win, regardless of whether they received more than half the
votes or not.
+</p>
+
+
+<br/><hr/>
+ <h2 id="stv">Single Transferable Vote</h2>
+ The single transferable vote (STV) system is designed to achieve
proportional representation through ranked voting in multi-seat elections.
+ It does so by allowing every voter one vote, that is transferable to other
candidates based on necessity of votes and the preference of the voter.
+ Thus, if a candidate in an election is voted in (or in case of a tie),
excess votes are allocated to candidates according to the preference of the
voter.
+ STV is designed to minimize the 'wasted votes' in an election by
reallocating votes (and thus the wishes of the voters) proportionally to their
previous priority.
+
+ Please see the <a
href="https://en.wikipedia.org/wiki/Single_transferable_vote#Voting";>Wikipedia
article on STV voting</a> for more insight into how STV works.
+
+ For calculating result, we use Meek's Method with a quota derived from the
Droop Quota but with implementation changes such as those proposed by New
Zealand.
+ See <a
href="http://svn.apache.org/repos/asf/steve/trunk/stv_background/meekm.pdf";>this
paper</a> for details.
+
+<br/><hr/>
+ <h2 id="dh">D'Hondt (Jefferson) Voting</h2>
+<p>The D'Hondt method, also known as the Jefferson method, is a <i>highest
average</i> method for calculating proportional representation of parties at an
election.
+ In essence, this is done by calculating a quotient per party for each
number of seats available and finding the highest values. The quotient is
determined as
+ <kbd>V/(s+1)</kbd> where <kbd>V</kbd> is the number of votes received
and <kbd>s</kbd> is the number of seats won. Thus, for each party, the quotient
is calculated
+ for the number of seats available:
+</p>
+ <h4>Example result for election with 4 seats:</h4>
+ <table border="1" cellpadding="2">
+ <tr><th>Party:</th><th>Votes:</th><th>1 seat:</th><th>2
seats:</th><th>3 seats:</th><th>4 seats:</th><th align='right'>seats
won:</th></tr>
+ <tr><td>Gnomes</td><td>25,000</td><td>25,000/(0+1) = <b
style='color:#396;'>25,000</b></td><td>25,000/(1+1) = <b
style='color:#396;'>12,500</b></td><td>25,000/(2+1) =
8,333</td><td>25,000/(3+1) = 6,250</td><td align='right'>2</td></tr>
+ <tr><td>Elves</td><td>15,000</td><td>15,000/(0+1) = <b
style='color:#396;'>15,000</b></td><td>15,000/(1+1) =
7,500</td><td>15,000/(2+1) = 5,000</td><td>15,000/(3+1) = 3,750</td><td
align='right'>1</td></tr>
+ <tr><td>Dwarves</td><td>10,000</td><td>10,000/(0+1) = <b
style='color:#396;'>10,000</b></td><td>10,000/(1+1) =
5,000</td><td>10,000/(2+1) = 3,333</td><td>10,000/(3+1) = 2,500</td><td
align='right'>1</td></tr>
+ </table>
+ <p>For more information on the D'Hondt Method, see <a
href="https://en.wikipedia.org/wiki/D'Hondt_method">this Wikipedia
article</a>.</p>
+
+{% endblock %}
