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

1. מה בעצם הבעיה

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

ככל שהספריה גדולה וותיקה יותר העניינים מסתבכים. כל API שהשתנה אומר שאנחנו הולכים למצוא ברשת תיעוד גם על ה API הישן וגם על החדש, ואם הגירסה הישנה עדיין נתמכת יהיו לנו התלבטויות איך לעשות דברים ואם צריך בכלל להשתמש בגירסה החדשה של ה API. כשריאקט עברו לעבוד עם Hooks עדיין הרבה מהתיעוד הכיל דוגמאות של קלאסים. ויו מכיל עדיין הרבה דוגמאות של Options API כולל באתר הרשמי, ועל ריילס אני לא רוצה בכלל להתחיל לדבר. לצערנו AI רק מחמירים את הבעיה כי הם למדו דרך האינטרנט ולכן הם מכירים את כל התחבירים אבל לא תמיד יודעים לבחור בשבילנו את התחביר שנכון ל Use Case שאנחנו צריכים. במיוחד בתחילת הדרך הסכנה בלימוד הדבר הלא נכון היא גדולה.

2. מתחילים באתר התיעוד הרשמי.

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

3. נעזרים ב Chat GPT כדי לבנות דברים, מתוך הבנה שהם לא יהיו טובים.

אחרי שלמדנו את הבסיס שצריך בשביל לכתוב דברים הגיע הזמן לחקור. פה ה AI הוא חבר טוב אפשר להיעזר ב Chat GPT, קלוד או דיפסיק או כל חבר אחר שלכם כדי להתחיל לכתוב קוד, לקבל תשובות במה להשתמש ולקבל Code Review על הקוד שכתבתם. אחרי שיש לכם כמה דברים שעובדים תוכלו לחזור למדריכים הרשמיים כדי ללמוד יותר, ומכאן מתחיל פינג-פונג בין בנייה לקריאה.

4. מחפשים אם יש אנשים אחרים שבנו דברים דומים ומוכנים לספר על זה.

אחרי שיש לכם הבנה מסוימת של הספריה ובניתם כמה דברים יהיה מעניין למצוא אנשים אחרים שבנו דברים דומים ומוכנים לספר על זה. בניתם משחק סנייק ב pygame? מעולה, עכשיו תחפשו פוסטים ברשת של אנשים שבנו את אותו משחק בפייגיים ותראו מה הם עשו דומה או שונה מכם. כתבתם גרפים כדי להבין data בעזרת echarts? מצוין עכשיו לכו לחפש אנשים אחרים שניתחו מידע באמצעות ספריה זו ותבינו מה הם עשו דומה או שונה מכם. בנקודה הזאת אנחנו עדיין לא באים כדי לשפוט אלא כדי ללמוד, אנחנו מוכנים לקבל שטעינו אם נמצא רעיון שנראה טוב יותר ברשת אבל מספיק בטוחים בעצמנו כדי לא לבלוע כל רעיון או הצעה.

5. מחפשים Style Guides ו Best Practices.

אחרי שראינו כמה דרכים ונעזרנו ב AI כדי להבין טוב יותר את ההבדלים בין הפיתרונות אנחנו במקום טוב כדי לחפש מדריכי Best Practices רשמיים על הטכנולוגיה. במדריכים אלה נמצא בדיוק את ההתלבטויות שהיו לנו עם עצות פרקטיות איזה שיטה טובה יותר ולמה.

6. מקשיבים לאנשים שבפנים.

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

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