1.1 --- a/app/main/help/introduction.lua	Mon Nov 10 19:06:38 2014 +0100
     1.2 +++ b/app/main/help/introduction.lua	Wed Dec 24 11:35:45 2014 +0100
     1.3 @@ -1,6 +1,7 @@
     1.4  ui.title(_"Introduction")
     1.5  
     1.6 -local lang = locale.get("lang")
     1.7 +-- show the user what can be done
     1.8 +execute.view { module = "index", view = "_sidebar_whatcanido" }
     1.9  
    1.10  ui.section(function()
    1.11    ui.sectionHead(function()
    1.12 @@ -8,46 +9,13 @@
    1.13    end)
    1.14    ui.sectionRow(function()
    1.15      ui.heading{ level = 2, content = _"Initiatives and issues" }
    1.16 -    if lang == "de" then
    1.17 -      ui.tag{ tag = "p", content = [[
    1.18 -        LiquidFeedback ist kein Umfragesystem, es werden keine bereits vorher feststehenden Fragen gestellt. Statt dessen kann jeder Teilnehmer neue Initiativen starten, die Vorschläge und/oder Argumente umfassen. Sobald eine Initiative eingestellt wurde, können alle Teilnehmer alternative Initiativen mit Gegenvorschlägen starten. Alle zueinander in Konkrurrenz stehenden Initiativen bilden zusammen ein Thema. Sowohl Themen als auch Initiativen werden nummeriert. Themen erhalten hierbei vor der Nummer ein #-Zeichen (z. B. #123), während Initiativen durch ein führendes i gekennzeichnet sind (z. B. i456). Ein Thema kann mehrere Initiativen enthalten. Nur eine Initiative kann gewinnen.
    1.19 -      ]] }
    1.20 -    else
    1.21 -      ui.tag{ tag = "p", content = [[
    1.22 -        LiquidFeedback is no survey, it doesn't ask you predefined questions. Instead every participant is allowed to post new initiatives containing a proposal and/or reasoning. As soon as the initiative is posted, all other participants can create alternative initiatives with counter proposals and/or reasoning. A group of concurring initiatives forms an issue. Issues in LiquidFeedback are numbered with a hash sign (e.g. #123) while initiatives are numbered with a leading "i" character (i456). In short: One issue may contain multiple initiatives. Only one initiative can win.
    1.23 -      ]] }
    1.24 -    end
    1.25 -      
    1.26 +    ui.tag{ tag = "p", content = _"[introduction] iniatives and issues" }
    1.27      ui.heading{ level = 2, content = _"Subject areas" }
    1.28 -    if lang == "de" then
    1.29 -      ui.tag{ tag = "p", content = [[
    1.30 -        Themen werden immer einem Themenbereich zugeordnet. Dies dient der Strukturierung der Diskussion und des Entscheidungsprozesses.
    1.31 -      ]] }
    1.32 -    else
    1.33 -      ui.tag{ tag = "p", content = [[
    1.34 -        Issues are always assigned to a subject area in order to structure the discussion and decision process.
    1.35 -      ]] }
    1.36 -    end
    1.37 +    ui.tag{ tag = "p", content = _"[introduction] subject areas" }
    1.38      ui.heading{ level = 2, content = _"Organizational units" }
    1.39 -    if lang == "de" then
    1.40 -      ui.tag{ tag = "p", content = [[
    1.41 -        Gliederungen ermöglichen Diskussionen und Entscheidungen auch für Teilmengen der Benutzer (z. B. Gliederungen einer Organisation). In jeder Gliederung können eigene Themenbereiche zur Verfügung stehen.
    1.42 -      ]] }
    1.43 -    else
    1.44 -      ui.tag{ tag = "p", content = [[
    1.45 -        To allow discussions and decisions by sub groups of participants (e.g. by the members of a subdivision of an organization), participants can be assigned to different units. Every organizational unit can have its own subject areas.
    1.46 -      ]] }
    1.47 -    end
    1.48 +    ui.tag{ tag = "p", content = _"[introduction] organizational units" }
    1.49      ui.heading{ level = 2, content = _"Rules of procedure" }
    1.50 -    if lang == "de" then
    1.51 -      ui.tag{ tag = "p", content = [[
    1.52 -        Ein Regelwerk definiert Fristen, Quoren und erforderliche Mehrheiten. Initiatoren wählen bei Erstellung eines Themas ein geeignetes Verfahren, das dem verfolgten Zweck entspricht.
    1.53 -      ]] }
    1.54 -    else
    1.55 -      ui.tag{ tag = "p", content = [[
    1.56 -        A policy defines the timing, quorums and required majorities for an issue in LiquidFeedback. Initiators choose the fitting policy for their purpose when creating a new issue.
    1.57 -      ]] }
    1.58 -    end
    1.59 +    ui.tag{ tag = "p", content = _"[introduction] rules of procedure" }
    1.60    end )
    1.61  end )
    1.62  ui.section(function()
    1.63 @@ -56,46 +24,13 @@
    1.64    end)
    1.65    ui.sectionRow(function()
    1.66      ui.heading{ level = 2, content = _"(1) Admission phase" }
    1.67 -    if lang == "de" then
    1.68 -      ui.tag{ tag = "p", content = [[
    1.69 -        Nicht jedes neue Thema wird auf ein Mindestinteresse der Teilnehmer stoßen. Daher muss ein neues Thema von einer vorab festzulegenden Mindestanzahl Teilnehmer als diskussionswürdig betrachtet  werden, um für die Diskussionsphase zugelassen zu werden. Andernfalls wird das Thema am Ende der Zulassungsphase abgebrochen und nicht weiter behandelt.
    1.70 -      ]] }
    1.71 -    else
    1.72 -      ui.tag{ tag = "p", content = [[
    1.73 -        As every participant can open a new issue in LiquidFeedback, not all of them will be intersting for at least a minimum of the participants. Therefore new issues need to gain a given quorum of supporters to become accepted for further discussion. Issues which do not reach the necessary quorum will be closed at the end of the admission phase.
    1.74 -      ]] }
    1.75 -    end
    1.76 +    ui.tag{ tag = "p", content = _"[introduction] phase 1 admission" }
    1.77      ui.heading{ level = 2, content = _"(2) Discussion phase" }
    1.78 -    if lang == "de" then
    1.79 -      ui.tag{ tag = "p", content = [[
    1.80 -        Während der Diskussionsphase arbeiten Initiativen auf die Verbesserung des Vorschlags und die Vervollkommnung der Argumentation hin, um die erforderliche Mehrheit zu erreichen und sich gegen eventuell vorhandene alternative Initiativen durchzusetzen.
    1.81 -      ]] }
    1.82 -    else
    1.83 -      ui.tag{ tag = "p", content = [[
    1.84 -        During the discussion phase all initiatives try to improve their proposals and reasoning to gain more supporters. The aim is to eventually reach the necessary majority and to beat alternative initiatives.
    1.85 -      ]] }
    1.86 -    end
    1.87 +    ui.tag{ tag = "p", content = _"[introduction] phase 2 discussion" }
    1.88      ui.heading{ level = 2, content = _"(3) Verification phase" }
    1.89 -    if lang == "de" then
    1.90 -      ui.tag{ tag = "p", content = [[
    1.91 -        Alle in dieser Phase angezeigten Initiativtexte können nicht mehr verändert werden. Neue Initiativen können gestartet aber ebenfalls nicht mehr geändert werden. Dieses Vorgehen schützt die Teilnehmer vor überraschenden Änderungen in letzter Minute.
    1.92 -      ]] }
    1.93 -    else
    1.94 -      ui.tag{ tag = "p", content = [[
    1.95 -        During the verification phase, initiative drafts with the proposal and reasoning become final and cannot be changed any more. So everyone can double check everything. In case of some last minute situation, it is still possible to add competing initiatives. But they cannot be edited again and need to gain supporters from scratch.
    1.96 -      ]] }
    1.97 -    end
    1.98 +    ui.tag{ tag = "p", content = _"[introduction] phase 3 verification" }
    1.99      ui.heading{ level = 2, content = _"(4) Voting phase" }
   1.100 -    if lang == "de" then
   1.101 -      ui.tag{ tag = "p", content = [[
   1.102 -        Jede Initiative, die eine Mindestanzahl an Unterstützern erreicht, wird zur Abstimmung zugelassen und erscheint auf dem Stimmzettel. Während der Abstimmung können die Teilnehmer mittels Präferenzwahl abstimmen, die es neben Zustimmung, Enthaltung und Ablehnung zusätzlich erlaubt Präferenzen zwischen den Initiativen anzugeben.
   1.103 -      ]] }
   1.104 -    else
   1.105 -      ui.tag{ tag = "p", content = [[
   1.106 -        Every initiative reaching a required quorum of supporters at the end of the verification phase is admitted for voting and appears on the voting ballot. During the voting phase every eligible participant may give a vote using a preferential voting system allowing to express individual preferences between the initiatives in addition to a yes/neutral/no vote.
   1.107 -      ]] }
   1.108 -    end
   1.109 -    
   1.110 +    ui.tag{ tag = "p", content = _"[introduction] phase 4 voting" }
   1.111    end)
   1.112  end)
   1.113  ui.section(function()
   1.114 @@ -103,15 +38,7 @@
   1.115      ui.heading{ level = 1, content = _"Vote delegation" }
   1.116    end)
   1.117    ui.sectionRow(function()
   1.118 -    if lang == "de" then
   1.119 -      ui.tag{ tag = "p", content = [[
   1.120 -        Delegationen ermöglichen eine dynamische Arbeitsteilung. Sie entsprechen einer Stimmrechtsvollmacht, können jederzeit geändert werden, sind weisungsfrei und übertragbar. Delegationen können für eine Gliederung, für einen Themenbereich der Gliederung oder für ein konkretes Thema erteilt werden. Konkretere Delegationen gehen allgemeineren Delegationen vor. Delegationen werden sowohl für den Diskurs (Phasen 1 bis 3) als auch für die Abstimmphase genutzt. Bei Aktivität eines Benutzers werden eventuell vorhandene Delegationen für die jeweilige Aktivität ausgesetzt.
   1.121 -      ]] }
   1.122 -    else
   1.123 -      ui.tag{ tag = "p", content = [[
   1.124 -        Delegations allow for a dynamic division of labor. A delegation is a proxy statement (voting power under a power of attorney), can be altered at any time, is not bound to directives and can be delegated onward. Delegations can be used for a whole organizational unit, for a subject area within an organizational unit, or for a specific issue. More specific delegations overrule more general delegations. Delegations are used in both the discourse (phase 1 to 3) and the voting phase. Any activity suspends existing delegations for the given activity.
   1.125 -      ]] }
   1.126 -    end
   1.127 +    ui.tag{ tag = "p", content = _"[introduction] vote delegation" }
   1.128    end)
   1.129  end)
   1.130  ui.section(function()
   1.131 @@ -119,14 +46,6 @@
   1.132      ui.heading{ level = 1, content = _"Preference voting" }
   1.133    end)
   1.134    ui.sectionRow(function()
   1.135 -    if lang == "de" then
   1.136 -      ui.tag{ tag = "p", content = [[
   1.137 -        Im Falle mehrerer ähnlicher Vorschläge auf dem Stimmzettel gibt es keine Notwendigkeit einen dieser Vorschläge auszuwählen. Stattdessen kann für (bzw. gegen) beliebig viele konkurrierende Initiativen gestimmt werden und gleichzeitig eine Präferenzreihenfolge dieser Initiativen angegeben werden. Die Präferenzen bestimmen den Gewinner, falls am Ende mehr als eine Initiative die notwendige Mehrheit an Ja-Stimmen erreicht. Auf diese Weise wird niemand ermutigt für eine Initiative zu stimmen, nur um eine andere Initiative zu verhindern, und es wird niemand ermutigt gegen eine Initiative zu stimmen, nur um einer anderen Initiative eine Chance zu geben.
   1.138 -      ]] }
   1.139 -    else
   1.140 -      ui.tag{ tag = "p", content = [[
   1.141 -        If there are similar competing proposals on the ballot, there is no necessity to choose one of them. Instead, it is possible to vote for (and against) as many initiatives as one wants to while being able to express the individual preferences amongst those initiatives during voting phase. Those preferences will determine the winner if more than one initiative has reached the necessary majority of approvals at end of voting phase. That way, nobody is encouraged to vote in favor of one initiative just to outrank another one, and nobody is encouraged to vote against an initiative just to increase the chances for another initiative to win.
   1.142 -      ]] }
   1.143 -    end
   1.144 +    ui.tag{ tag = "p", content = _"[introduction] preference voting" }
   1.145    end)
   1.146  end)

     2.1 --- a/locale/translations.de.lua	Mon Nov 10 19:06:38 2014 +0100
     2.2 +++ b/locale/translations.de.lua	Wed Dec 24 11:35:45 2014 +0100
     2.3 @@ -763,6 +763,16 @@
     2.4  ["[event mail]     Issue: ##{id}"] = "       Thema: ##{id}";
     2.5  ["[event mail]     Phase: #{phase}"] = "       Phase: #{phase}";
     2.6  ["[event mail]    Policy: #{policy}"] = "   Regelwerk: #{policy}";
     2.7 +["[introduction] iniatives and issues"] = "LiquidFeedback ist kein Umfragesystem, es werden keine bereits vorher feststehenden Fragen gestellt. Statt dessen kann jeder Teilnehmer neue Initiativen starten, die Vorschläge und/oder Argumente umfassen. Sobald eine Initiative eingestellt wurde, können alle Teilnehmer alternative Initiativen mit Gegenvorschlägen starten. Alle zueinander in Konkrurrenz stehenden Initiativen bilden zusammen ein Thema. Sowohl Themen als auch Initiativen werden nummeriert. Themen erhalten hierbei vor der Nummer ein #-Zeichen (z. B. #123), während Initiativen durch ein führendes i gekennzeichnet sind (z. B. i456). Ein Thema kann mehrere Initiativen enthalten. Nur eine Initiative kann gewinnen.";
     2.8 +["[introduction] organizational units"] = "Gliederungen ermöglichen Diskussionen und Entscheidungen auch für Teilmengen der Benutzer (z. B. Gliederungen einer Organisation). In jeder Gliederung können eigene Themenbereiche zur Verfügung stehen.";
     2.9 +["[introduction] phase 1 admission"] = "Nicht jedes neue Thema wird auf ein Mindestinteresse der Teilnehmer stoßen. Daher muss ein neues Thema von einer vorab festzulegenden Mindestanzahl Teilnehmer als diskussionswürdig betrachtet  werden, um für die Diskussionsphase zugelassen zu werden. Andernfalls wird das Thema am Ende der Zulassungsphase abgebrochen und nicht weiter behandelt.";
    2.10 +["[introduction] phase 2 discussion"] = "Während der Diskussionsphase arbeiten Initiativen auf die Verbesserung des Vorschlags und die Vervollkommnung der Argumentation hin, um die erforderliche Mehrheit zu erreichen und sich gegen eventuell vorhandene alternative Initiativen durchzusetzen.";
    2.11 +["[introduction] phase 3 verification"] = "Alle in dieser Phase angezeigten Initiativtexte können nicht mehr verändert werden. Neue Initiativen können gestartet aber ebenfalls nicht mehr geändert werden. Dieses Vorgehen schützt die Teilnehmer vor überraschenden Änderungen in letzter Minute.";
    2.12 +["[introduction] phase 4 voting"] = "Jede Initiative, die eine Mindestanzahl an Unterstützern erreicht, wird zur Abstimmung zugelassen und erscheint auf dem Stimmzettel. Während der Abstimmung können die Teilnehmer mittels Präferenzwahl abstimmen, die es neben Zustimmung, Enthaltung und Ablehnung zusätzlich erlaubt Präferenzen zwischen den Initiativen anzugeben.";
    2.13 +["[introduction] preference voting"] = "Im Falle mehrerer ähnlicher Vorschläge auf dem Stimmzettel gibt es keine Notwendigkeit einen dieser Vorschläge auszuwählen. Stattdessen kann für (bzw. gegen) beliebig viele konkurrierende Initiativen gestimmt werden und gleichzeitig eine Präferenzreihenfolge dieser Initiativen angegeben werden. Die Präferenzen bestimmen den Gewinner, falls am Ende mehr als eine Initiative die notwendige Mehrheit an Ja-Stimmen erreicht. Auf diese Weise wird niemand ermutigt für eine Initiative zu stimmen, nur um eine andere Initiative zu verhindern, und es wird niemand ermutigt gegen eine Initiative zu stimmen, nur um einer anderen Initiative eine Chance zu geben.";
    2.14 +["[introduction] rules of procedure"] = "Ein Regelwerk definiert Fristen, Quoren und erforderliche Mehrheiten. Initiatoren wählen bei Erstellung eines Themas ein geeignetes Verfahren, das dem verfolgten Zweck entspricht.";
    2.15 +["[introduction] subject areas"] = "Themen werden immer einem Themenbereich zugeordnet. Dies dient der Strukturierung der Diskussion und des Entscheidungsprozesses.";
    2.16 +["[introduction] vote delegation"] = "Delegationen ermöglichen eine dynamische Arbeitsteilung. Sie entsprechen einer Stimmrechtsvollmacht, können jederzeit geändert werden, sind weisungsfrei und übertragbar. Delegationen können für eine Gliederung, für einen Themenbereich der Gliederung oder für ein konkretes Thema erteilt werden. Konkretere Delegationen gehen allgemeineren Delegationen vor. Delegationen werden sowohl für den Diskurs (Phasen 1 bis 3) als auch für die Abstimmphase genutzt. Bei Aktivität eines Benutzers werden eventuell vorhandene Delegationen für die jeweilige Aktivität ausgesetzt.";
    2.17  ["[not displayed public]"] = "[nicht öffentlich]";
    2.18  ["abandoned"] = "ausgesetzt";
    2.19  ["accept invitation"] = "Einladung annehmen";

     3.1 --- a/locale/translations.en.lua	Mon Nov 10 19:06:38 2014 +0100
     3.2 +++ b/locale/translations.en.lua	Wed Dec 24 11:35:45 2014 +0100
     3.3 @@ -763,6 +763,16 @@
     3.4  ["[event mail]     Issue: ##{id}"] = "     Issue: ##{id}";
     3.5  ["[event mail]     Phase: #{phase}"] = "     Phase: #{phase}";
     3.6  ["[event mail]    Policy: #{policy}"] = "    Policy: #{policy}";
     3.7 +["[introduction] iniatives and issues"] = "LiquidFeedback is no survey, it doesn't ask you predefined questions. Instead every participant is allowed to post new initiatives containing a proposal and/or reasoning. As soon as the initiative is posted, all other participants can create alternative initiatives with counter proposals and/or reasoning. A group of concurring initiatives forms an issue. Issues in LiquidFeedback are numbered with a hash sign (e.g. #123) while initiatives are numbered with a leading \"i\" character (i456). In short: One issue may contain multiple initiatives. Only one initiative can win.";
     3.8 +["[introduction] organizational units"] = "To allow discussions and decisions by sub groups of participants (e.g. by the members of a subdivision of an organization), participants can be assigned to different units. Every organizational unit can have its own subject areas.";
     3.9 +["[introduction] phase 1 admission"] = "As every participant can open a new issue in LiquidFeedback, not all of them will be intersting for at least a minimum of the participants. Therefore new issues need to gain a given quorum of supporters to become accepted for further discussion. Issues which do not reach the necessary quorum will be closed at the end of the admission phase.";
    3.10 +["[introduction] phase 2 discussion"] = "During the discussion phase all initiatives try to improve their proposals and reasoning to gain more supporters. The aim is to eventually reach the necessary majority and to beat alternative initiatives.";
    3.11 +["[introduction] phase 3 verification"] = "During the verification phase, initiative drafts with the proposal and reasoning become final and cannot be changed any more. So everyone can double check everything. In case of some last minute situation, it is still possible to add competing initiatives. But they cannot be edited again and need to gain supporters from scratch.";
    3.12 +["[introduction] phase 4 voting"] = "Every initiative reaching a required quorum of supporters at the end of the verification phase is admitted for voting and appears on the voting ballot. During the voting phase every eligible participant may give a vote using a preferential voting system allowing to express individual preferences between the initiatives in addition to a yes/neutral/no vote.";
    3.13 +["[introduction] preference voting"] = "If there are similar competing proposals on the ballot, there is no necessity to choose one of them. Instead, it is possible to vote for (and against) as many initiatives as one wants to while being able to express the individual preferences amongst those initiatives during voting phase. Those preferences will determine the winner if more than one initiative has reached the necessary majority of approvals at end of voting phase. That way, nobody is encouraged to vote in favor of one initiative just to outrank another one, and nobody is encouraged to vote against an initiative just to increase the chances for another initiative to win.";
    3.14 +["[introduction] rules of procedure"] = "A policy defines the timing, quorums and required majorities for an issue in LiquidFeedback. Initiators choose the fitting policy for their purpose when creating a new issue.";
    3.15 +["[introduction] subject areas"] = "Issues are always assigned to a subject area in order to structure the discussion and decision process.";
    3.16 +["[introduction] vote delegation"] = "Delegations allow for a dynamic division of labor. A delegation is a proxy statement (voting power under a power of attorney), can be altered at any time, is not bound to directives and can be delegated onward. Delegations can be used for a whole organizational unit, for a subject area within an organizational unit, or for a specific issue. More specific delegations overrule more general delegations. Delegations are used in both the discourse (phase 1 to 3) and the voting phase. Any activity suspends existing delegations for the given activity.";
    3.17  ["[not displayed public]"] = false;
    3.18  ["abandoned"] = false;
    3.19  ["accept invitation"] = false;