<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[116851] branches/gsoc11-statistics/stats-server</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta">
<dt>Revision</dt> <dd><a href="https://trac.macports.org/changeset/116851">116851</a></dd>
<dt>Author</dt> <dd>cal@macports.org</dd>
<dt>Date</dt> <dd>2014-02-08 08:17:48 -0800 (Sat, 08 Feb 2014)</dd>
</dl>
<h3>Log Message</h3>
<pre>macports stats: add FAQ and Credits</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#branchesgsoc11statisticsstatsserverconfigroutesrb">branches/gsoc11-statistics/stats-server/config/routes.rb</a></li>
</ul>
<h3>Added Paths</h3>
<ul>
<li><a href="#branchesgsoc11statisticsstatsserverappcontrollersstatic_controllerrb">branches/gsoc11-statistics/stats-server/app/controllers/static_controller.rb</a></li>
<li>branches/gsoc11-statistics/stats-server/app/views/static/</li>
<li><a href="#branchesgsoc11statisticsstatsserverappviewsstaticcreditshtmlerb">branches/gsoc11-statistics/stats-server/app/views/static/credits.html.erb</a></li>
<li><a href="#branchesgsoc11statisticsstatsserverappviewsstaticfaqhtmlerb">branches/gsoc11-statistics/stats-server/app/views/static/faq.html.erb</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="branchesgsoc11statisticsstatsserverappcontrollersstatic_controllerrb"></a>
<div class="addfile"><h4>Added: branches/gsoc11-statistics/stats-server/app/controllers/static_controller.rb (0 => 116851)</h4>
<pre class="diff"><span>
<span class="info">--- branches/gsoc11-statistics/stats-server/app/controllers/static_controller.rb         (rev 0)
+++ branches/gsoc11-statistics/stats-server/app/controllers/static_controller.rb        2014-02-08 16:17:48 UTC (rev 116851)
</span><span class="lines">@@ -0,0 +1,2 @@
</span><ins>+class StaticController < ApplicationController
+end
</ins></span></pre></div>
<a id="branchesgsoc11statisticsstatsserverappviewsstaticcreditshtmlerb"></a>
<div class="addfile"><h4>Added: branches/gsoc11-statistics/stats-server/app/views/static/credits.html.erb (0 => 116851)</h4>
<pre class="diff"><span>
<span class="info">--- branches/gsoc11-statistics/stats-server/app/views/static/credits.html.erb         (rev 0)
+++ branches/gsoc11-statistics/stats-server/app/views/static/credits.html.erb        2014-02-08 16:17:48 UTC (rev 116851)
</span><span class="lines">@@ -0,0 +1,24 @@
</span><ins>+<h2>Credits</h2>
+<p>
+        The MacPorts statistics web application and the initial client were written by <%= link_to "Derek Ingrouville", "https://trac.macports.org/wiki/derek" %>
+        when MacPorts participated in <%= link_to "Google Summer of Code 2011", "https://trac.macports.org/wiki/SummerOfCode2011" %>. Some documentation for the
+        source written in GSoC can be found in <%= link_to "the Wiki", "https://trac.macports.org/wiki/MacPortsStatisticsGSoC2011" %>. The source code for the
+        server is available in MacPorts' Subversion repository at <%= link_to "/branches/gsoc11-statistics", "https://trac.macports.org/browser/branches/gsoc11-statistics" %>.
+</p>
+<p>
+        The current installation of the statistics server has been modified and is run by MacPorts Developer <%= link_to "Clemens Lang", "https://trac.macports.org/wiki/cal" %>.
+</p>
+<p>
+        The client implementation as the <code>mpstats</code> port is the work of <%= link_to "Derek Ingrouville", "https://trac.macports.org/wiki/derek" %>,
+        <%= link_to "Joshua Root", "https://trac.macports.org/wiki/jmr" %> and <%= link_to "Clemens Lang", "https://trac.macports.org/wiki/cal" %>. The source of
+        the client is currently available at <%= link_to "/users/cal/ports/macports/mpstats", "http://trac.macports.org/browser/users/cal/ports/macports/mpstats" %>
+        in the MacPorts Subversion repository.
+</p>
+
+<h2>Source</h2>
+<p>Both the statistics client and the statistics server are open source:
+        <ul>
+                <li><%= link_to "client", "http://trac.macports.org/browser/users/cal/ports/macports/mpstats" %></li>
+                <li><%= link_to "server", "https://trac.macports.org/browser/branches/gsoc11-statistics" %></li>
+        </ul>
+</p>
</ins></span></pre></div>
<a id="branchesgsoc11statisticsstatsserverappviewsstaticfaqhtmlerb"></a>
<div class="addfile"><h4>Added: branches/gsoc11-statistics/stats-server/app/views/static/faq.html.erb (0 => 116851)</h4>
<pre class="diff"><span>
<span class="info">--- branches/gsoc11-statistics/stats-server/app/views/static/faq.html.erb         (rev 0)
+++ branches/gsoc11-statistics/stats-server/app/views/static/faq.html.erb        2014-02-08 16:17:48 UTC (rev 116851)
</span><span class="lines">@@ -0,0 +1,63 @@
</span><ins>+<h2>Frequently Asked Questions</h2>
+
+<a name="collected-data"></a>
+<h3>Which Statistics Are Collected?</h3>
+<p>The MacPorts statistics collects and submits the following information to the server:</p>
+<ul>
+        <li>
+                <strong>A unique identifier for your MacPorts installation</strong><br />
+                This identifier is generated by <code>uuidgen</code> when you first
+                install the statistics service. We use this identifier to overwrite
+                statistics data you submitted earlier – we keep at most one set of
+                statistics per user per month. The identifier does not convey any
+                information about your system or location.
+        </li>
+        <li>
+                <strong>Version numbers and system properties</strong><br />
+                The statistics service collects and submits the versions of MacPorts,
+                OS X, GCC and Xcode installed on your system. It also tells us what
+                your CPU architecture, platform and build target architecture are.
+        </li>
+        <li>
+                <strong>A list of your installed ports</strong><br />
+                The statistics daemon collects and sends a list of the ports you have
+                installed containing the following information for each port:
+                <ul>
+                        <li>name and installed version</li>
+                        <li>whether the port is active or inactive</li>
+                        <li>chosen variants</li>
+                </ul>
+        </li>
+</ul>
+
+<a name="collection-frequency"></a>
+<h3>How Often Are Statistics Sent?</h3>
+<p>The statistics daemon runs once a week, overwriting the data your
+installation did submit earlier in the same month, if any. If the daemon fails
+to send the data, the error is silently ignored.</p>
+
+<a name="why-statistics"></a>
+<h3>Why Do You Need Statistics?</h3>
+<p>We'd like to improve our understanding of how MacPorts and its ports are
+used. The statistics will help us determine which operating systems, build
+architectures and Xcode versions we need to support and test to provide
+a better overall experience for our users and less unexpected failures. The
+stats will also help us understand how quickly new MacPorts releases or port
+updates are adopted and how long we should wait before we can start using new
+features. The variant statistics will hopefully reveal ports where variants
+other than the default ones are popular choices and for which ports it might be
+advisable to test non-standard variants when updating a port, or even which
+variants should become defaults. We hope to use the variants data to build
+binary packages for non-default, but popular variants in the future.</p>
+
+<a name="opt-in"></a>
+<h3>How Can I Submit Statistics?</h3>
+<p>To start submitting statistics, install the <code>mpstats</code> port in
+your MacPorts installation.</p>
+
+<a name="opt-out"></a>
+<h3>How Do I Stop Submitting Statistics?</h3>
+<p>Uninstalling the <code>mpstats</code> port will prevent your system from
+submitting further statistics. Note that MacPorts will never default to
+submitting statistics. If you didn't explicitly <a href="#opt-in">opt-in</a>,
+MacPorts does not send statistics.</p>
</ins></span></pre></div>
<a id="branchesgsoc11statisticsstatsserverconfigroutesrb"></a>
<div class="modfile"><h4>Modified: branches/gsoc11-statistics/stats-server/config/routes.rb (116850 => 116851)</h4>
<pre class="diff"><span>
<span class="info">--- branches/gsoc11-statistics/stats-server/config/routes.rb        2014-02-08 16:16:46 UTC (rev 116850)
+++ branches/gsoc11-statistics/stats-server/config/routes.rb        2014-02-08 16:17:48 UTC (rev 116851)
</span><span class="lines">@@ -1,17 +1,13 @@
</span><span class="cx"> StatsServer::Application.routes.draw do
</span><del>-
</del><ins>+
</ins><span class="cx"> get "home/index"
</span><span class="cx">
</span><span class="cx"> resources :submissions
</span><del>-
</del><span class="cx"> resources :os_statistics
</span><del>-
</del><span class="cx"> resources :installed_ports
</span><del>-
</del><span class="cx"> resources :categories, :only => [:index] do
</span><span class="cx"> match '/ports/page/:page', :to => 'ports#index', :page => :page
</span><del>- resources :ports, :only => [:index, :show]
-
</del><ins>+ resources :ports, :only => [:index, :show]
</ins><span class="cx"> end
</span><span class="cx">
</span><span class="cx"> match '/ports/page/:page', :to => 'ports#index', :page => :page
</span><span class="lines">@@ -19,7 +15,7 @@
</span><span class="cx"> match '/ports/search', :to => 'ports#search_generate', :as => :search_generate
</span><span class="cx"> match '/ports/search/:criteria/:val/page/:page', :to => 'ports#search', :criteria => :criteria, :val => :val, :page => :page
</span><span class="cx"> match '/ports/search/:criteria/:val', :to => 'ports#search', :criteria => :criteria, :val => :val, :as => :search
</span><del>-
</del><ins>+
</ins><span class="cx"> root :to => 'home#index'
</span><del>-
</del><ins>+ match ':action' => 'static#:action'
</ins><span class="cx"> end
</span></span></pre>
</div>
</div>
</body>
</html>