From 6ca812b89cf22b12bb1cb91ba18dbcac5e038e31 Mon Sep 17 00:00:00 2001
From: Dave Whiteland <dave@mysociety.org>
Date: Thu, 3 Jul 2014 11:50:14 +0100
Subject: add .po glossary entry

---
 docs/glossary.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

(limited to 'docs/glossary.md')

diff --git a/docs/glossary.md b/docs/glossary.md
index 64c75c603..6e0bc8915 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -27,6 +27,7 @@ Definitions
   <li><a href="#holding_pen">holding pen</a></li>
   <li><a href="#newrelic">New Relic</a></li>
   <li><a href="#mta">MTA</a></li>
+  <li><a href="#po">.po files</a></li>
   <li><a href="#production">production site</a></li>
   <li><a href="#publish">publish</a></li>
   <li><a href="#recaptcha">recaptcha</a></li>
@@ -332,6 +333,36 @@ Definitions
     </div>
   </dd>
 
+  <dt>
+    <a name="po"><code>.po</code> file</a> (and <code>.pot</code> file)
+  </dt>
+  <dd>
+    These are the files needed by the gettext mechanism Alaveteli uses for
+    localisation. A <code>.pot</code> file is effectively a list of all the
+    strings in the application that need translating. Each <code>.po</code>
+    file contains the mapping between those strings, used as keys, and their
+    translations for one particular language. The key is called the
+    <em>msgid</em>, and its corresponding translation is the <em>msgstr</em>.
+    <div class="more-info">
+      <p>More information:</p>
+      <ul>
+        <li>
+          See <a href="{{ site.baseurl }}docs/customising/translation/">translating
+          Alaveteli</a> for an overview from a translator's point of view.
+        </li>
+        <li>
+          See <a href="{{ site.baseurl }}docs/developers/i18n/">Internationalising
+          Alaveteli</a> for more technical details.
+        </li>
+        <li>
+          Alaveteli is on the  <a href="https://www.transifex.net/projects/p/alaveteli/">Transifex</a>
+          website, which lets translators work on Alaveteli in a browser, without needing
+          to worry about this underlying structure.
+        </li>
+      </ul>
+    </div>
+  </dd>
+
   <dt>
     <a name="production">production site</a> (also: live, production server)
   </dt>
-- 
cgit v1.2.3


From 1baf9bda6b22ab6bbe8ae2d1b69f127b79273b40 Mon Sep 17 00:00:00 2001
From: Dave Whiteland <dave@mysociety.org>
Date: Thu, 3 Jul 2014 12:35:59 +0100
Subject: add release/release manager to glossary

---
 docs/glossary.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

(limited to 'docs/glossary.md')

diff --git a/docs/glossary.md b/docs/glossary.md
index 6e0bc8915..5eb45943b 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -34,6 +34,7 @@ Definitions
   <li><a href="#redact">redacting</a></li>
   <li><a href="#regexp">regular expression</a></li>
   <li><a href="#request">request</a></li>
+  <li><a href="#release">release</a></li>
   <li><a href="#response">response</a></li>
   <li><a href="#rails">Ruby&nbsp;on&nbsp;Rails</a></li>
   <li><a href="#sass">Sass</a></li>
@@ -512,6 +513,41 @@ Definitions
     </div>
   </dd>
 
+  <dt>
+    <a name="release">release</a> (also: release manager)
+  </dt>
+  <dd>
+    We issue new <strong>releases</strong> of the Alaveteli code whenever key
+    work (new features, improvements, bugfixes, and so on) have been added to
+    the core code. Releases are identified by three numbers: major, minor, and
+    &mdash; if necessary &mdash; a patch number. We recommend you always use
+    the latest version. The process is handled by the Alaveteli <strong>release
+    manager</strong>, who decides what changes are to be included in the
+    current release, and the cut-off date for the work. Currently this is
+    Alaveteli's lead developer at mySociety.
+    <div class="more-info">
+      <p>More information:</p>
+      <ul>
+        <li>
+          The latest stable release is on the
+          <a href="https://github.com/mysociety/alaveteli/tree/master">master branch</a>.
+        </li>
+        <li>
+          See a <a href="https://github.com/mysociety/alaveteli/releases">list of all releases</a>.
+        </li>
+        <li>
+          We try to coordinate releases with any active translation work too.
+          See <a href="http://localhost:4000/docs/customising/translation/">translating
+          Alaveteli</a> for more information.
+        </li>
+        <li>
+          We encourage you use the <a href="{{site.baseurl}}docs/installing/deploy/">deployment
+          mechanism</a>, which makes it easier to keep your production server up-to-date.
+        </li>
+      </ul>
+    </div>
+  </dd>
+
   <dt>
     <a name="request">request</a>
   </dt>
-- 
cgit v1.2.3


From 4730bdea85bf7e294885d89e9ebcc9a1151e73ac Mon Sep 17 00:00:00 2001
From: Dave Whiteland <dave@mysociety.org>
Date: Thu, 3 Jul 2014 12:38:56 +0100
Subject: fix quirky alternative alphabetic order in glossary

---
 docs/glossary.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

(limited to 'docs/glossary.md')

diff --git a/docs/glossary.md b/docs/glossary.md
index 5eb45943b..7a7c5d003 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -409,15 +409,6 @@ Definitions
     information provided in response.
   </dd>
 
-  <dt>
-    <a name="response">response</a>
-  </dt>
-  <dd>
-    A <strong>response</strong> is the email sent by an
-     <a href="#authority" class="glossary">authority</a> in reply to
-     a user's  <a href="#request" class="glossary">requests</a>.
-  </dd>
-
   <dt>
     <a name="recaptcha">recaptcha</a>
   </dt>
@@ -561,6 +552,15 @@ Definitions
     to all the requests it sends.
   </dd>
 
+  <dt>
+    <a name="response">response</a>
+  </dt>
+  <dd>
+    A <strong>response</strong> is the email sent by an
+     <a href="#authority" class="glossary">authority</a> in reply to
+     a user's  <a href="#request" class="glossary">requests</a>.
+  </dd>
+
   <dt>
     <a name="rails">Ruby on Rails</a> (also Rails)
   </dt>
-- 
cgit v1.2.3