חזרה לכל השאלות

איך מסבירים נושא מורכב בלינקדאין?

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

למי אתם מסבירים את הנושא?

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

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

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

איך דוגמה עוזרת להסביר רעיון מורכב?

בפוסט על פרויקט הקוד הפתוח שלי כתבתי: "בניתי את real-browser-mcp, פרויקט open source שמאפשר לסוכני AI לעבוד בדפדפן האמיתי שלכם, עם החשבונות שכבר מחוברים אליו".

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

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

אילו מונחים צריך להסביר?

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

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

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

מה אסור לאבד כשמקצרים?

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

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

מתי כדאי להשתמש בדימוי?

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

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

איך בודקים שההסבר ברור?

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

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

רוצים עזרה בהסברת נושא מקצועי בפוסט? ספרו לי במה אתם עוסקים ומה הייתם רוצים שהקורא יבין.

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