דף זה מכיל את הפרטים של פרויקט כתיבה טכנית שהתקבל בעונה של Google Docs.
סיכום הפרויקט
- ארגון הקוד הפתוח:
- מערכת ההפעלה של Qubes
- כתב טכני:
- c1e0
- שם הפרויקט:
- איחוד מדריכים לפתרון בעיות
- אורך הפרויקט:
- אורך רגיל (3 חודשים)
תיאור הפרויקט
מופשט
מדריך לפתרון בעיות נועד לעזור למשתמשי קצה לפתור בעיות שהם נתקלים בהן במהלך השימוש במוצר או בשירות שלהם. חשוב להיעזר במדריך טוב לפתרון בעיות, כי הוא עוזר למשתמשים כשיש בעיות. כך המשתמשים לא ינטשו מוצר כשהם נתקלים בבעיה. ל-Qubes יש אלפי משתמשים יומיים ברחבי העולם, ורבים מהם ייתקלו בבעיה בשלב כלשהו, וייהנו ממדריך לפתרון בעיות.
המצב הנוכחי של המדריך לפתרון בעיות
בשלב זה, המדריכים לפתרון בעיות של QubesOS מפוזרים בין דפים רבים ולפעמים לא שלמים, וכתוצאה מכך הם מפרסמים שוב ושוב את אותה הנחיה כדי לאבחן בעיות. במדריכים הזמינים חסרה פריסה של תסמינים-פעולה, ולכן המשתמש מתקשה להתאים בעיה לפתרון שלה. בנוסף, יש כמה בעיות שהוזכרו שוב ושוב ברשתות החברתיות (Reddit), בדף הבעיות של Qubes ב-GitHub ובפורום #qubes-users, אבל לא תועדו במדריך הנוכחי לפתרון בעיות.
למה המדריך המוצע שלי לפתרון בעיות הוא שיפור בהשוואה למצב הנוכחי?
המדריך שלי לפתרון בעיות יהיה מלא ומובנה כדי להבטיח שהניווט יהיה מדויק וקל לניווט. במדריך מוצגות הוראות תמציתיות שמסבירות איך לפתור בעיה, שלב אחר שלב. היא תכלול פריסה של תגובה לפי תסמינים, שבה תצוין הבעיה, ואחריה יוצג פתרון מומלץ לפתרון הבעיה. פתרון הבעיות יעבור אופטימיזציה למנועי חיפוש וינוסח כך שישקף את הבעיות שמשתמשים מחפשים ברשתות החברתיות ובמנועי החיפוש. כל הפעולות האלה יבטיחו שהמשתמשים יוכלו למצוא את המדריך הרשמי לפתרון בעיות במנועי חיפוש, ולמצוא במהירות/בקלות פתרון לבעיות שלהם
המבנה של המדריך לפתרון בעיות ומסגרת הזמן
יצרתי הצעה של מבנה למדריך לפתרון בעיות במערכת ההפעלה של Qubes, שניתן למצוא כאן: https://docs.google.com/document/d/187NlnEvctYVVUnRuGtwY2PkYBVxBSSPfpSwZEaczqL8/edit?usp=sharing. לפריסה יש טווח זמן משוער שבמהלכו ייכתב כל קטע של פתרון בעיות. הפריסה הזו תיושם לאחר קבלת משוב מהמנטור. המבנה ומסגרת הזמן עשויים להשתנות בהתאם למשוב מהמנטור.
יעדי הפרויקט
- בנו מחדש את המדריך לפתרון בעיות כך שתהיה פריסה מאוחדת וברורה יותר של פעולות תסמינים.
- לשכתב את פתרון הבעיות הקיימות כדי לקבל הוראות מפורטות וקלות לביצוע.
- מוסיפים צילומי מסך לפי הצורך
- התקנה וניסיון של Qubes בעצמי ותיעוד בעיות שנתקלת בהן. יש לי שלושה מחשבים: Lenovo Thinkpad, Dell Direct ו-Acer Aspire. אנסה את Qubes בכל אחד מהמחשבים האלה, אתעד את השגיאות ואאמת את הפתרונות לבעיות.
- מסירים מידע מיושן מהמדריך הקיים.
- לוודא שפתרונות הבעיות מדויקים. נכון לעכשיו, במדריכים הקיימים לפתרון בעיות מוצגת הודעת השגיאה "זהו תיעוד לא רשמי של צד שלישי. לא ניתן להבטיח את הדיוק של דף זה בפרויקט Qubes OS. יש לנקוט משנה זהירות". האזהרה הזו תימחק אחרי אימות הדיוק של ההוראות לפתרון בעיות. הם יבטיחו את הדיוק שלהם על ידי בדיקה אישית של פתרון הבעיות במחשבים שלי (אם ניתן), או בדיקה באינטרנט אם משתמשים מסוימים אימתו את הפתרון.
- מעבירים כל פתרון בעיות חיצוני (מהפורום ומ-GitHub) לדף האינטרנט הרשמי לפתרון בעיות.
- חקרו ומצאו בעיות נוספות שבהן נתקלים משתמשים מ-Reddit (r/QubesOS), מ-Stack Exchange, מ- #qubes-users מקבוצת Google ומ-GitHub. בנוסף, אשתמש בכלים למחקר של מילות מפתח, כמו Keywordtool.io ו-UberSuggest.com, כדי לגלות אילו שאלות משתמשים לעתים קרובות במנועי חיפוש כמו Google.
- מוסיפים את הקטע 'קבלת עזרה', למקרה שהמדריך לפתרון בעיות לא פותר את הבעיה של המשתמשים. לדוגמה, בדף פתרון הבעיות של Fedora: https://docs.fedoraproject.org/en-US/fedora/raw עדכני/install-guide/install/troubleshooting/#sect-troubleshooting-getting-help.
למה כדאי להשתמש בפרויקט הזה?
אני אוהב טכנולוגיה, במיוחד אבטחת סייבר ופרטיות. אני מאמינה שכתיבה היא אחד מהמצבים הכי חזקים שלי. מערכת ההפעלה Qubes מעניינת אותי במיוחד כי היא מצטלבת בין שני אינטרסים עיקריים - אבטחה ופרטיות. אני משתמש נלהב של מוצרים אחרים שמתמקדים באבטחה ובפרטיות, כמו DuckDuckGo ו-Tor. רק לאחרונה גיליתי את מערכת ההפעלה של Qubes, והיא מוצאת חן בעיניי עד כה.
למה אני מאמין שאני האדם הנכון בפרויקט הזה
- אני אוהבת לשמור על אבטחה, פרטיות ולכתוב מסמכים מועילים/טובים.
- נתקלתי בבעיות בהתקנה של Qubes OS ובשימוש בה, לכן אוכל להציג את הבעיות האלה בצורה טובה יותר בהוראות לפתרון בעיות.
- בחודש האחרון, למדתי את ההיבטים הטכניים של מערכת ההפעלה של קוויב. בנוסף, חקרתי לעומק את התיעוד של מערכת ההפעלה של Qubes. כדי להתנסות בתהליך עריכת המסמכים, יצרתי בקשת משיכה (https://github.com/QubesOS/qubes-doc/pull/1005/files)
- לאחרונה השלמתי התמחות בפרויקט Tor. התפקידים שלי היו תמיכה טכנית וכתיבה. במהלך העבודה במחלקת התמיכה, קיבלתי מאות שאלות ממשתמשים שנתקלו בבעיות בהתקנה של Tor Browser או בשימוש בו. כשעזרתי למשתמשים האלה לפתור את הבעיות שלהם, למדתי איך לכתוב הוראות תמציתיות ומובנות לפתרון בעיות.
- במהלך העבודה ב-Tor Project, כתבתי גם מסמכים טכניים באמצעות Markdown. השתמשתי ב-Git, GitHub ו-GitLab לבקרת גרסאות.