פרויקט FreeBSD

דף זה מכיל את הפרטים של פרויקט כתיבה טכנית שהתקבל בעונה של Google Docs.

סיכום הפרויקט

ארגון הקוד הפתוח:
פרויקט FreeBSD
כתב טכני:
קאפיין
שם הפרויקט:
יצירת פרק בספר יין
אורך הפרויקט:
אורך רגיל (3 חודשים)

תיאור הפרויקט

במסגרת היוזמה הזו, הייתי מפיק פרק מפורט באורך מדריך ב-FreeBSD, שקשור להתקנה, לשימוש ולפתרון הבעיות של WINE (www.winehq.org) ב-FreeBSD. אני רוצה להקדיש 4-8 שעות בשבוע לעבודה על הפריטים שלמטה, אלא אם צוין אחרת.

*** חיבורים קהילתיים

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

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

*** שבוע 1 (14/9-19): התקנות ופתרון בעיות

בשבוע הראשון של שלב פיתוח המסמך השתמשתי בביצוע התקנה יבשה של WINE בגרסה היציבה הנוכחית של FreeBSD, ובנוסף התקנתי והתקנתי מגוון של אפליקציות Windows, החל מכלי עזר פשוטים ועד לאפליקציות מורכבות יותר. זו גישה שהשתמשתי בה במאמר דומה שעשיתי על ReactOS for MakeUseOf (https://www.makeuseof.com/tag/reactos-open-source-windows-clone/), אבל הייתי מקדיש את הזמן של השבוע הראשון כדי לבחון מבחר רחב יותר של תוכניות.

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

מטרת השבוע: לכלול מתווה של סניפי ההתקנה ופרטים נחוצים לפתרון בעיות נפוצות בהתקנה.

*** שבוע 2 (21-25 בספטמבר): תיעוד ההתקנה של WINE

במהלך שבוע 2 הייתי כותב טיוטה של הקטעים שמתארים את ההתקנה של WINE בשיטות פופולריות, כולל:

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

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

היעד השבועי: גרסת טיוטה משופרת של הקטעים שמתארים את ההתקנה של WINE באתר של FreeBSD. 'טיוטה משופרת' הזו צריכה לכלול טקסט כמעט סופי (בהמתנה להגהה ולבדיקה של משוב) ו-placeholders לצילומי מסך, אם לא צילומי המסך עצמם.

*** שבוע 3 (28/9-10/2): הפעלת תוכנית WINE הראשונה של FreeBSD

לאחר התקנת מערכת המשנה WINE, החלק הבא יפרט את ההתקנה והביצוע של כמה תוכנות ראשוניות. רוב הסיכויים שהם יתמקדו בכלים פשוטים ועצמאיים, כמו Notepad++ בקוד פתוח. המטרה היא לאפשר למשתמשים להוריד אפליקציה במהירות, להתקין אותה ולראות שהיא פועלת במינימום מאמץ.

חשוב להבהיר למשתמשים שאפליקציות מסוימות של Windows, או אפליקציות רבות, יכולות לפעול ב-FreeBSD, ולכן אפשרות זו מתאימה למחשוב יומיומי.

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

*** שבוע 4 (5/10-9): WINE סקירה כללית ומושגים

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

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

היעד של השבוע: טיוטה משופרת של הקטעים שמציגה את מערכת המשנה WINE למשתמשים.

*** שבוע 5 (12-10/10): תצורת WINE ב-FreeBSD

קטעים אלה יכללו פרטים נוספים לגבי התצורה בפועל של WINE, ותתחילו בשינויים/כוונונים ספציפיים ל-FreeBSD. הן גם ימחישו את השימוש בתיקיות $WINEPREFIX, שבהן ניתן להשתמש כדי להתאים אישית את סביבת WINE לאפליקציה ספציפית. מכיוון שיש מקורות מידע קיימים שמסבירים את התפיסה הזו לעומק, הקטע הזה כולל מבוא מפורט רק במידה בינונית לפני הקישור אליהם.

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

*** שבוע 6 (19-23 באוקטובר): WINE GUIs ב-FreeBSD

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

  • WINECFG
  • יקבים
  • Playonbsd
  • הרשאות אחרות

היעד של השבוע: לספק קטעי טיוטה מטופחים עם הוראות להתקנה ושימוש בכמה שיותר מאפליקציות העזרה הפופולריות ביותר של GUI WINE.

*** שבוע 7 (26/10-30): שאלות נפוצות על WINE/FreeBSD (מחקר)

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

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

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

היעד השבועי: טיוטות של קטעי טיוטות שמכילים את הבעיות הנפוצות ביותר ב-WINE, כפי שחוו משתמשי FreeBSD באופן כללי, וקישורים/הערות לגבי הפתרונות שלהם. לתשומת ליבכם: אומנם לעבודה שנמשכה השבוע אין תפוקה, אבל סביר להניח שתצטרכו להשקיע יותר זמן כדי לאתר בעיות נפוצות ולפתור אותן, וגם לעקוב אחרי הפתרונות שלהן. אני מצפה להשקיע 8-10 שעות על המחקר הזה.

*** שבוע 8 (2-11/6): שאלות נפוצות על WINE/FreeBSD

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

היעד השבועי: טיוטה מטופחת של הקטעים שבהם מפורטות השאלות הנפוצות/בעיות נפוצות, והוראות מפורטות לפתרון הבעיות.

*** שבוע 9 (9-11/13): ניהול WINE במשתמשים מרובים

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

היעד השבועי: טיוטה של טיוטות מפורטות המכילה הנחיות ושיטות מומלצות עבור מנהלי מערכת של FreeBSD לפריסה של אפליקציות מבוססות WINE ו-WINE אצל משתמשים מרובים.

*** שבוע 10 (16/11-20): נספחים, משוב לביקורת וניהול

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

בנוסף, במהלך תקופה זו אכתוב את כל פרטי הניהול הנדרשים לפרק הזה במדריך הזה (חומר קדמי, אינדקסים וכו'), וארכיב חומר קריאה נוסף שקשור ל-WINE (למשל, שימוש בגרסת Linux של WINE באמצעות תאימות בינארית, DOSBox למשחקים/תוכניות ישנים וכו').

היעד של השבוע: טיוטה משופרת של כל פרק המדריך, שכולל את כל הקטעים האחרים.

*** שבוע 11 (23-23/11): סופי שבוע במדריך

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

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

*** שבוע 12 (30/11-12/5): סיום פרויקט

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