עריכת הוראות שימוש לתוכנת משוב נוזלי

=כללי=
משוב נוזלי (LiquidFeedback (ובקיצור lqfb) היא תוכנה חופשית לעיצוב דעה פוליטית וקבלת החלטות, תוך טשטוש הגבולות בין דמוקרטיה ייצוגית וישירה. התכונה החשובה ביותר שלה היא היישום של מערכת הצבעה המאפשרת למצביעה להעביר את סמכותה לעמיתה ("דמוקרטיה נוזלית"), תכונה שעתידה לייסד צורה חדשה של ייצוג והשתתפות פוליטית, הלוקחת בחשבון את אי-הסימטריה בידע של המשתתפות בהצבעה. (מקור: ויקיפדיה האנגלית, עוד מידע על משוב נוזלי (באנגלית) ניתן לקרא [http://en.wikipedia.org/wiki/LiquidFeedback שם] או [http://he.wikipedia.org/wiki/%D7%9E%D7%A9%D7%95%D7%91_%D7%A0%D7%96%D7%99%D7%9C בויקיפדיה העברית].)
==בארץ==
בארץ קיימת קבוצת עבודה בשם "מפלגה פתוחה" ([https://groups.google.com/forum/?hl=en&fromgroups#!forum/omiflaga כאן ניתן לעיין ברשימת התפוצה שלה]). לפי דיווחו של אלון, חבר בקבוצה, הקבוצה הקדישה את משאביה לתרגום ממשק המשתמש לשפה העברית. בתרגום זה נעשה שימוש גם בהתקנת משוב נוזלי של [[מפלגת העם]].

=מושגים בסיסיים ותהליך ההצבעה=
משוב נוזלי מאפשרת לדון בסוגיות, שהן הצעות להחלטה. כל משתמש/ת במערכת יכולה להציע סוגיה.

===הצעת סוגיה חדשה===
סוגיה הינה כותרת לנושא שיש לדון בו. כדי להעלות סוגיה נדרש להשתתף בתחום אליו הסוגיה שייכת. למשל, להשתתף בתחום שנקרא "בחירות 2013" כדי להציע סוגיה כגון "קוי אופי למפלגה", או להשתתף בתחום "תקנון למפלגה" כדי להציע תיקונים לתקנון.

העלאת הסוגיה הינה תהליך בלתי הפיך - לא ניתן להסיר סוגיות מסדר היום. הסוגיות יורדות באופן אוטומטי אחרי מספר ימים ללא עניין ציבורי. תהליך זה מוסבר בסעיף הבא - קוורום.

===טיוטה לפתרון הסוגיה, חלופות לפתרון והערות על החלופות===
תהליך העלאת סוגיה חדשה מחייב להזין גם חלופה אפשרית לפתרון הסוגיה - "טיוטא". את הטקסט של החלופה יכולה יוזמת החלופה לערוך ואפילו להזמין עוד שותפים לעריכה משותפת של הטקסט. הגרסאות השונות של טקסט החלופה נשמרות במשוב הנוזלי וניתן להשוות את ההבדלים ביניהן.
 
יוזמת החלופה יכולה גם לבטל את החלופה. החלופה תשאר באתר אך תופיע כ"מבוטלת".

לכל חלופה ניתן להזין חלופות אלטרנטיביות, אם יש לך רעיון שונה משמעותית לפתרון הסוגיה.

לכל חלופה ניתן להזין הערות - אם החלופה מקובלת עליך באופן עקרוני אך חשוב לך להכניס בה שינוי קטן.

===תהליך קוורום ראשוני===
לאחר העלאת סוגיה, נדרש שלפחות 10% מבעלות/י זכות ההצבעה, יביעו עניין בהצעה - "קוורום". סוגיות שבהן הביע עניין לפחות 10% מקהל בעלי זכות ההצבעה, ממשיכות הלאה לשלב הדיון. אחרת הן יורדות מסדר היום. 

===שלב הדיון===
בשלב הדיון (ולמעשה כבר מרגע העלאת הסוגיה), כל מי שיש לה זכות הצבעה, רשאית להציע:
#הערות לחלופת הבסיס (בעצם הערות על הסוגיה כפי שנוסחה ע"י יוזמיה). יוזמי חלופת הבסיס יכולים להתייחס להצעה או להתעלם ממנה.
#להציע חלופה חדשה לפתרון אותה סוגיה. זוהי למעשה גישה אחרת לאותה סוגיה. לכשתגיע הסוגיה לשלב ההצבעה, הקהל יצטרך לבחור בין החלופות השונות. גם החלופות עוברות תהליך קוורום, כלומר, כדי שחלופה שאיננה חלופת הבסיס תעלה להצבעה, נדרש שלפחות 10% ממביעי העניין בסוגיה, יביעו עניין בחלופה.

===חצי קיפאון===
בתום תהליך הדיון, הסוגיה והחלופות השונות נכנסות ביחד למצב "חצי קפוא". מטרת מצב זה היא לשקף לכל בעלות זכות ההצבעה, מהן החלופות הקיימות ולאפשר לגבש דעה לקראת ההצבעה. בשלב זה יש למעט (או שבכלל לא ניתן) לערוך שינויים בחלופות השונות לפתרון סוגיה זו.
===הצבעה===
בתום מצב ה"חצי קיפאון", הסוגיה עוברת למצב "קפוא", כלומר, מצב הצבעה.

בתום פרק הזמן שהוקדש להצבעה - הסוגיה עוברת למצב "סגור".

=הרשמה למערכת וזכות ההצבעה=
==מדיניות סף כניסה וקבלת זכות הצבעה==
ב[[מפלגת העם]] אנחנו מפעילים מדיניות זמנית שמחייבת פעילות בשטח או ברשת כדי לקבל זכות הצבעה. (בקרוב גם המדיניות הזו תועלה לדיון).

*'''עדיין לא השתתפת בפעילות?''' אין בעיה! לרשותך [[רשימת רעיונות לפעילות במפלגת העם]]. בחר/י לך רעיון ו-יאללה, לעבודה :-) כמובן חזרי/חזור אחר כך לדווח לנו על הפעילות, כדי שנקנה לך את זכות ההצבעה המגיעה לך.

*'''השתתפת בפעילות של המפלגה בשבוע האחרון?''' מצויין! כדי לדווח על פעילות, ראי את ההוראות בדף [[הוראות לדיווח על פעילות באתר התפעול של מפלגת העם]]. שימי לב שמדובר בשתי מערכות שונות - אתר התפעול דורש הרשמה, שם וסיסמה; ואתר משוב נוזלי, שדורש גם הרשמה, שם וסיסמה. בעתיד אולי מישהו יקח אחריות לחבר בין שתי המערכות וכך לחסוך לכולנו זמן. ברגע שדיווחת על פעילות, תקבלי למייל הודעה עם פרטי כניסה למערכת משוב נוזלי. לחלופין, אם כבר יש ברשותך משתמש למערכת משוב נוזלי, דיווח הפעילות יקנה למשתמש עוד שבוע של זכות הצבעה. מן הסתם, לאחר שבוע של חוסר פעילות במפלגה, זכות ההצבעה תוסר מהמשתמש. כדי להקנות אותה חזרה, יש לדווח על פעילות מפלגתית חדשה.


כל התהליך הזה עדיין חדש, ולכן אפשר ורצוי לשאול את ברוך אורן אם נתקלים במשהו מוזר או שסתם יש שאלה. ברוך 0523-563147  info@barochoren.com

הוראות שימוש למערכת משוב נוזלי ניתן לקרא כאן, בהמשך דף זה.

==כניסה בפעם הראשונה למשוב נוזלי (לאחר קבלת זכות הצבעה)==
#יתקבל מייל עם קוד הזמנה. יש לבצע את הכניסה הראשונית למערכת בתוך שבוע מקבלת הקוד, שכן אחרי כן עשויה זכות ההצבעה לפוג, והכניסה למערכת תחסם זמנית עד לקבלת זכות הצבעה. 
#יש להקליק על הקישור במייל או להעתיק את קוד ההזמנה ולמלא אותו בקישור הבא: http://haam.barochoren.com/lf/index/register.html
#לאחר הזנת קוד הכניסה, תועברי למסך שבו יש לאשר את תנאי השימוש (לסמן X) ולמלא כתובת מייל וסיסמה. בשלב זה תתבקשי להקליד סיסמה ולאשר אותה.
#כעת את בתוך המערכת.

=כניסה למערכת משוב נוזלי=
קישור לכניסה למערכת לצפייה בלבד: http://haam.barochoren.com/lf/

קישור לכניסה למערכת למשתמשות בעלות זכות הצבעה: http://haam.barochoren.com/lf/index/login.html?redirect_view=index&redirect_module=index

יש להכנס לארגון "מפלגת העם". בארגון זה ישנם שני תחומים: בדיקות ובחירות 2013.
=שימוש במערכת=
== מה קורה פה בדיוק?==
כדאי לקרא שוב את הסעיף [http://www.shakufbaohel.org.il/index.php?title=%D7%94%D7%95%D7%A8%D7%90%D7%95%D7%AA_%D7%A9%D7%99%D7%9E%D7%95%D7%A9_%D7%9C%D7%AA%D7%95%D7%9B%D7%A0%D7%AA_%D7%9E%D7%A9%D7%95%D7%91_%D7%A0%D7%95%D7%96%D7%9C%D7%99#.D7.9E.D7.95.D7.A9.D7.92.D7.99.D7.9D_.D7.91.D7.A1.D7.99.D7.A1.D7.99.D7.99.D7.9D_.D7.95.D7.AA.D7.94.D7.9C.D7.99.D7.9A_.D7.94.D7.94.D7.A6.D7.91.D7.A2.D7.94 מושגים בסיסיים ותהליך ההצבעה] ממש כאן למעלה.

==איפה רואים מי הצביע? איך מצביעים בעצמי?==
#במערכת המשוב הנוזלי, הקלק על "עמוד ראשי" ואז "כל הארגונים" ומשם הקלק על "מפלגת העם" (או ב[http://haam.barochoren.com/lf/unit/show/1.html קישורית הזו]).
#בדף זה ניתן לראות את כל התחומים במפלגה. לגבי כל תחום, אפשר לבחור להתעלם ממנו (ברירת מחדל), להשתתף בו (יש להקליק "השתתפות בתחום זה") או להאציל את זכות ההצבעה בתחום זה לאדם אחר (יש להקליק "האצל תחום").
#מתחת לכל תחום יש סיכום של מספר הסוגיות הפתוחות לדיון, הצבעה וכו' באותו תחום.
#כדי לראות מי הצביע או להצביע, יש להגיע לדף הסוגיה הסצפציפי באמצעות הקלקה על "פתוחים" "בדיון" "בהצבעה" וכדומה - עבור התחום הרלוונטי. תופיע רשימת הסוגיות במצב המבוקש - יש לבחור את הסוגיה שמעניינת אותי.
#כמו נושא התחומים - גם לגבי סוגיות אפשר לבחור להתעלם מהסוגיה, להתעניין בה או להאציל את הטיפול בה לאדם אחר. כדי להשתתף בדיון או להצביע, יש צורך להקליק על "הוסף את העניין שלי" לסוגיה המתאימה.
#כעת יש להקליק על כותרת הסוגיה (מופיעה עם האות i באנגלית ולידה מספר).
#בדף הסוגיה - יש שלושה בלוקים - כחול, צהוב ולבן. 
:#בבלוק הכחול ניתן להוסיף או להסיר את העניין וכן להאציל את זכות ההצבעה. בנוסף אפשר לראות שם קו ירוק המציג באופן גרפי, כמה מבעלות זכות ההצבעה הביעו עניין בסוגיה זו, והאם כמות מביעי העניין עברה את סף הקוורום להעלאת סוגיות לסדר היום (כרגע עומד על 10% מבעלי זכות ההצבעה). עוד אפשרי בבלוק זה להציע אלטרנטיבה- חלופה לפתרון המוצע לסוגיה. בין החלופות הללו תתנהל ההצבעה - בשאלה, מי החלופה שתזכה ליותר תמיכה מקהל המצביעים. בבלוק הכחול הזה יופיע גם הקישור הנכסף '''"הצבע / בטל הצבעה"''', כאשר הסוגיה תכנס לשלב ההצבעה. לפירוט השלבים בחיי סוגיה, ראו את הסעיף [http://www.shakufbaohel.org.il/index.php?title=%D7%94%D7%95%D7%A8%D7%90%D7%95%D7%AA_%D7%A9%D7%99%D7%9E%D7%95%D7%A9_%D7%9C%D7%AA%D7%95%D7%9B%D7%A0%D7%AA_%D7%9E%D7%A9%D7%95%D7%91_%D7%A0%D7%95%D7%96%D7%9C%D7%99#.D7.9E.D7.95.D7.A9.D7.92.D7.99.D7.9D_.D7.91.D7.A1.D7.99.D7.A1.D7.99.D7.99.D7.9D_.D7.95.D7.AA.D7.94.D7.9C.D7.99.D7.9A_.D7.94.D7.94.D7.A6.D7.91.D7.A2.D7.94 מושגים בסיסיים ותהליך ההצבעה] ממש כאן למעלה.
:#הבלוק הצהוב מציג עזרה - ניתן להסתיר אותו בפינתו השמאלית-עליונה.
:#בבלוק הלבן יש אפשרות לקרא את תוכן ההצעה
:#מתחת לבלוק הלבן ישנה אפשרות להעיר הערה על ההצעה הנוכחית - כדי שהיוזמת של ההצעה הנוכחית תבין מה מפריע לי בחלופה שהיא מציעה.

==איך להסמיך איש:ה אחר:ת להצביע בשמי בסוגיה מסויימת?==
ישנן שלוש רמות הסמכה:
*הסמכה /ייפוי כח מלא בכלל הסוגיות.
*הסמכה/ייפוי כח בתחום מסויים.
*הסמכה/ייפוי כח בסוגיה ספציפית.

הסמכה ניתן לעשות רק למי שנמצאת ברשימת אנשות הקשר שלך.
 להוספת איש:ה לרשימת אנשות הקשר שלך, יש להקליק "חיפוש" "search" ולרשום את שמו:ה.
 יש להקליק על שמו/ה בתוצאות החיפוש ואז להקליק "הוספה לאנשי הקשר שלי" "add to my contacts"

את ההסמכה עצמה מבצעים לפי רמת ההסמכה:
* הסמכה כללית, עושים מדף הרמה הארגונית הרלוונטית.
*הסמכה לתחום מסויים, בדף התחום המסויים.
*הסמכה לסוגיה הספציפית, בדף הסוגיה הספציפית.

'''ביטול הסמכה''' מבוצע בדיוק באותו מקום בו מבוצעת ההסמכה.

==הוספת הצעת מדיניות חדשה==
משתמשות רשומות למערכת, להן זכויות הצבעה ביחידה ארגונית, יכולות להוסיף הצעת מדיניות לדיון באיזורי עניין של אותה יחידה ארגונית. לצורך כך עליהן להיות משתתפות בתחום. 

#יש להכנס ליחידה ארגונית בה יש לך זכויות הצבעה.
#יש לבחור את התחום הרלוונטי.
#במידה ואינך רשומה עדיין כמשתתפת בתחום זה, עליך להקליק על "השתתפי בתחום זה" " participate in this area"
#יש להקליק על "צרי סוגיה חדשה" "create new issue"
#יש להזין את השדות הבאים:
{|class="wikitable"
!שם השדה
!תיאור
|-
|מדיניות הצבעה policy
|שם מדיניות ההצבעה המבוקשת. מדיניות ההצבעה קובעת בין היתר את משך הזמן שמוקצה לדיון בסוגיה ולהצבעה עצמה. ניתן להקליק על "Information about the available policies (new window)" כדי לקבל פירוט על רשימת כלל המדיניויות האפשריות במערכת. 
|-
|Title of initiative
|כותרת עבור הצעת המדיניות
|-
|Draft טיוטא
|ניסוח טקסט חלופת הפתרון לסוגיה
|}

==הוספת חלופה להצעת מדיניות קיימת==
בחלונית שבצד שמאל, מתחת לכותרת "'''אני לא אוהב/ת את הצעת המדיניות הזו ואני רוצה להוסיף את דעתי או מדיניות חלופית'''", בחר/י בקישורית "'''הצע מדיניות מתחרה חדשה'''".
[[קובץ:הוספת חלופה.png]]

==איך מאפשרים לעוד חברים לערוך יחד איתי את החלופה שהעליתי?==
ניתן להזמין רק אנשי קשר שלך. 
===הגדרת אנשי קשר באתר===
#הקלק על mifleget haam instance בשורה העליונה (רקע שחור) ותגיע לעמוד הבית. 
#הקלק על "חברים" 
#הקלק על המשתמש שאתה רוצה להגדיר כאיש קשר
מהבלוק הלבן בראש האתר, הקלק על "הגדר כאיש קשר".

===הוספת חברים כיוזמים של החלופה, כדי שיוכלו לערוך===
הכנס לדף הסוגיה והקלק על תיאור היוזמה שלך.
בראש הבלוק הלבן, בשורה הראשונה, ישנו קישור "הזמן חברים ליוזמה".

=מדיניות הצבעה=
ישנם משתנים רבים המשפיעים על תהליך ההצבעה. ננתח כאן חלק מהם.

רק מנהלות מערכת יכולות ליצור מדיניות הצבעה חדשה או לשנות את המאפיינים של מדיניות הצבעה קיימת.
{|class="wikitable"
!שם המשתנה
!משמעות
!ערך ברירת מחדל
|-
|Index
|מספר סידורי של מדיניות ההצבעה. קובע את הסדר (מיקום) ברשימות.
|-
|Active
|במידה וכן, ניתן להשתמש במדיניות זו עבור סוגיות חדשות.
|-
|Name
|שם מדיניות ההצבעה
|-
|Description
|תיאור מדיניות ההצבעה
|-
|Admission time
|משך הזמן המקסימלי בו הסוגיה נמצאת במצב 'Admission'. תוך פרק זמן זה על הסוגיה לעבור למצב "התקבל" 'Accepted', אחרת היא מוסרת מסדר היום.
|8 ימים
|-
|Discussion time
|משך הזמן בו הסוגיה נמצאת במצב דיון. לאחר שסוגיה התקבלה, היא נכנסת למצב דיון. בדרך כלל בתום פרק הזמן הזה הסוגיה עוברת למצב "חצי מוקפא". 
|15 ימים
|-
|Verification time
|משך הזמן בו הסוגיה נמצא במצב אימות. לאחר שתם פרק הזמן לדיון, הסוגיה מועברת למצב "חצי מוקפא". בדרך כלל בתום פרק הזמן לאימות סוגיות "חצי מוקפאות", הן עוברות למצב קיפאון מוחלט, כלומר, מצב הצבעה.
|8 ימים
|-
|Voting time
|משך הזמן בו ניתן להצביע בסוגיה. זהו משך הזמן בו הסוגיה במצב "הצבעה" בטרם תועבר למצב "סגור".
|15 ימים
|-
|Issue quorum numerator
|מונה עבור מינימום משתתפים(בהצבעה) בחלופה מסויימת לסוגיה על מנת שתחשב כ"מאושרת" ותיכנס למצב "דיון"'''
|-
|Issue quorum denumerator
|מכנה עבור מינימום משתתפים(בהצבעה) בחלופה מסויימת לסוגיה על מנת שתחשב כ"מאושרת" ותיכנס למצב "דיון"'''
|-
|Initiative quorum numerator
|מונה עבור מינימום משתתפים(בהצבעה) בחלופה מסויימת לסוגיה על מנת שתחשב כ"מאושרת" ותיכנס למצב "דיון"'''
|- 
|Initiative quorum denumerator
|מכנה עבור מינימום משתתפים(בהצבעה) בחלופה מסויימת לסוגיה על מנת שתחשב כ"מאושרת" ותיכנס למצב "דיון"'''
|- 
|Direct majority numerator
|מונה עבור רוב ישיר לחלופות על מנת שאלה יוגדרו כמנצחות
|-
|Direct majority denumerator
|מכנה עבור רוב ישיר לחלופות על מנת שאלה יוגדרו כמנצחות
|-
|Strict direct majority
|אם מוגדר TRUE, הרוב הישיר חייב להיות גדול מאחוז הרוב הישיר שהוגדר. אחרת, מספיק שהוא יהיה שווה (לאחוז הרוב הישיר שהוגדר)
|-
|Direct majority positive
|מספר אבסולוטי של "positive_votes" על מנת שחלופה תוגדר כמנצחת
|-
|Direct majority non negative
|מספר אבסולוטי של סכום ה-"positive_votes" והנמנעים על מנת שחלופה תוגדר כמנצחת
|-
|Indirect majority numerator
|מונה עבור רוב עקיף על מנת שחלופה תוגדר כמנצחת
|-
|Indirect majority denumerator
|מכנה עבור רוב עקיף על מנת שחלופה תוגדר כמנצחת.
|-
|Strict indirect majority
|אם מוגדר TRUE, הרוב העקיף חייב להיות גדול מאחוז הרוב העקיף שהוגדר. אחרת, מספיק שהוא יהיה שווה (לאחוז הרוב העקיף שהוגדר)
|-
|Indirect majority positive
|Absolute number of votes in favor of the winner neccessary in a beat path to the status quo for an initaitive to be attainable as winner
|-
|Indirect majority non negative
|Absolute number of sum of votes in favor and abstentions in a beat path to the status quo for an initiative to be attainable as winner
|-
|No reverse beat path
|Causes initiatives with "reverse_beat_path" flag to not be "eligible", thus disallowing them to be winner. See comment on column "initiative"."reverse_beat_path". This option ensures both that a winning initiative is never tied in a (weak) condorcet paradox with the status quo and a winning initiative always beats the status quo directly with a simple majority.
|-
|No multistage majority
|Causes initiatives with "multistage_majority" flag to not be "eligible", thus disallowing them to be winner. See comment on column "initiative"."multistage_majority". This disqualifies initiatives which could cause an instable result. An instable result in this meaning is a result such that repeating the ballot with same preferences but with the winner of the first ballot as status quo would lead to a different winner in the second ballot. If there are no direct majorities required for the winner, or if in direct comparison only simple majorities are required and "no_reverse_beat_path" is true, then results are always stable and this flag does not have any effect on the winner (but still affects the "eligible" flag of an "initiative").
|-
|Polling mode
|TRUE = special policy for non-user-generated issues without issue quorum, where certain initiatives (those having the "polling" flag set) do not need to pass the initiative quorum; "admission_time" MUST be set to NULL, the other timings may be set to NULL altogether, allowing individual timing for those issues
|FALSE
|}

=תקלות נפוצות=
אם נתקלתם בהודעה כגון:
 Not Found
 
 The requested URL /index/login.html was not found on this server.

יש להוסיף לכתובת האתר את האותיות lf כגון: 
 http://haam.barochoren.com/lf/index/login.html
==מקומות בהם יש את הבעיה==
*בתהליך הרישום הראשוני
*במכתב אישרור המייל
*באשרור הקוד באתר עצמו (סבמיט ל ../members )
*HIDE THIS HELP MESSAGE לאחר כניסה למערכת
=הוראות התקנה ודברים שמהנדסי תוכנה מתעניינים בהם=
==הוספת השפה העברית==
גישה לbitbucket של צוות מפלגה פתוחה: https://bitbucket.org/apeled/liquid_feedback_frontend_heb
#להוסיף את הקובץ translations.he.lua לספרייה frontend/locale
#לערוך את frontend/config/init.lua ולהוסיף he כשפה. ולבחור בה כשפת ברירת מחדל.


=מונחים שיעזרו לנו להבין מה הולך פה=

===Quorum/קוורום===
דרישה למספר מינימלי של משתתפים בהצבעה כדי להקנות לה תוקף
===Issue===
סוגיה
===Initiative===
חלופה