כתיבת הסברים (באנגלית ובעברית)י

[evyatark]

כתיבת הסברים (באנגלית ובעברית) על שיטות עבודה מוצעות, החל מאפריל 2019, בעקבות הפגישה ב15 באפריל

product: this page!

and this one also...

[OrBin]

Is Hebrew really needed? I think that maintaining documentation in two languages will make one (if not both) of them become out-of-date at some point.

[evyatark]

I truly hope that Hebrew is NOT needed. But it means that everybody should be prepared to write in English. And if someone is not fluent in English, he/she might not participate.

[OrBin]

You are right, but I believe it's an elementary requirement. Am I wrong?

[evyatark]

You are correct. But we should check if all current team members feel ok to write in English

[evyatark]

I added a strong recommendation to NOT use Hebrew.

[cjer]

Two comments -

1. I think this content should appear in a CONTRIBUTING.md file . Github also has built-in features for directing people to read and comply to contribution guidelines (see here)
2. I opened an issue for organizing our issues Organize github Issues #185 (we're entering the matrix here I know). The issue labels should be simple and helpful to our task management, so I would love your input on that. After we agree on labels we should update the contribution guidelines content too.

About English - I wish we could do all this in Hebrew. If RTL is the main concern, as you mentioned there are some solutions, that are not so bad. If English only content will make our disscussions less efficient and open, I think we should think of a solution that will work well for Hebrew.

קצת מצחיק שכתבתי את כל זה באנגלית. קיצר, יש פתרונות ל-RTL. והם לא נראים לי רעים מאוד. אם זו הבעיה המרכזית, ואנגלית תגרום לדיונים להיות פחות זורמים אני חושב שכדאי לעבוד על להשריש את השימוש בהם. נראה לכם ש-RTL באמת מגביל מאוד? יש עוד סיבות שאתם חושבים שכדאי להתנהל פה באנגלית בלבד?

[evyatark]

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

[cjer]

הבעיה המרכזית ב-"אנגלית בלבד" בעיני היא שאנחנו רוצים שה-Issues פה יהיו גם תחליף לפורום, ולא רק מקום ל-Features ו-Bug-Requests מוגמרים. אני חושב שבטווח הארוך זה יגביל מאוד את אופי או את משתתפי הדיונים כאן אם הכל יהיה באנגלית. אשמח לעוד דעות @AvivSela @adiwaz @ronlik26 @eldadru

[cjer]

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

[evyatark]

ידע לא צריך להיקרא מתוך דיונים. אם במהלך הדיון יש משהו שהוא "ידע" אז כדאי מאוד לכתוב אותו ב WIKI

דן - האם מוסכם שעמודי ה WIKI שמרכזים את הידע שלנו כן יהיו באנגלית בלבד?

[cjer]

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

עמודי WIKI נשמע לי בסדר גמור שיהיו באנגלית (אפשר גם ליצור בעתיד גרסאות מקבילות מתורגמות אם נראה לזה צורך). הבעיה שלי היא בעיקר עם דיונים ושאלות-תשובות.

[OrBin]

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

[AvivSela]

אפשר גם לשלב - את הדיונים #discussion לא נגביל להיות בשפה מסויימת ואת שאר הדברים שאמורים להיות סגורים ומוגדרים יותר נעשה באנגלית

לגבי הסברים בוויקי הייתי כותב באנגלית ומתרגם את אלו שאמורים לפנות לקהל שחדש בפרוייקט ודובר עברית

[OrBin]

שוב, הבעיה בלתרגם היא שתמצא את עצמך עם תוכן לא מעודכן באחת מהשפות (אם לא בשתיהן...)

[AvivSela]

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

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

[adiwaz]

Closing this issue. We have other issues opened for documentation, and future tasks.