המושג
הידע של הקוראים
היחס שצריך להסביר
הסבירו רעיון לא מוכר באמצעות השוואות יומיומיות, עם מיפוי ברור בין החלקים והסבר היכן ההשוואה נשברת.
הפרטים נפתחים לבדיקה ב־Vizify. המשימה מתחילה רק לאחר שליחה שם, בהתאם להרשאות ולכללי הקרדיטים של החשבון.
המושג
הידע של הקוראים
היחס שצריך להסביר
טקסט או Markdown
אנלוגיה מסייעת להבנה ואינה ראיה לכך ששתי מערכות פועלות באופן זהה בכל היבט.
1. מפתח עניינים בספר: במקום לקרוא את כל העמודים, מחפשים נושא ומגיעים לעמודים המתאימים. גם אינדקס מסייע למצוא רשומות לפי ערך. הגבול: מסד נתונים משתנה, ולעיתים צריך לעדכן את האינדקס בכל שינוי; זו אינה רשימת עמודים קבועה. 2. כרטיסיות מסודרות לפי מספר: קל יותר למצוא כרטיס לקוח מסוים כשיש סדר שימושי. אינדקס מחזיק מבנה שמאיץ חיפוש בשדות מסוימים. הגבול: קיימים סוגי אינדקסים שונים, וסדר אחד אינו מתאים לכל שאילתה. 3. מדריך למגירות: המדריך אומר באיזו מגירה נמצא התיק, בלי לפתוח את כולן. אינדקס יכול להפנות למיקום הרשומה. הגבול: לפעמים האינדקס עצמו כולל מספיק מידע לתשובה; בנוסף, הוא תופס מקום ודורש עבודה כשמוסיפים או משנים נתונים.
הסבירו אינדקס במסד נתונים לעובד משרד חדש בשלוש אנלוגיות יומיומיות וציינו היכן כל אחת מפסיקה להתאים.
איזה מושג ברצונך להסביר, ולמי מיועד ההסבר? כדאי לציין מה קשה להבנה ואילו פרטים אסור לאנלוגיה לשנות. כך אפשר להציע השוואות עם הסבר לגבולות שלהן, בלי להציג דמיון כהוכחה ששתי המערכות פועלות באותו אופן.
אני רוצה להשתמש ב„מחולל אנלוגיות”, אבל הפרט הזה עדיין חסר: „המושג”. בקשו את הפרטים או המקור החסרים במקום להמציא תוצאה מוכנה.
בודק שנשאלת שאלה כשחסר בסיס, במקום להמציא עובדות או תוצאה מוכנה.
כן. ציינו גיל וידע מוקדם ובקשו הסבר שמחבר את האנלוגיה למושג האמיתי אחרי הדוגמה.
כן. ציינו מסגרת מוכרת כמו מטבח או ספרייה. ההשוואה צריכה להסביר קשר ולא רק להוסיף קישוט לשוני.
בקשו לציין היכן היא מפסיקה להתאים. בדקו את המיפוי מול המקור ואל תרחיבו לתכונות שלא הוסברו.
ארגנו בבקשה את המידע הרלוונטי: המושג; הידע של הקוראים; היחס שצריך להסביר. סמנו מה לא ידוע במקום להציגו כעובדה. הפרידו בין דרישות שחייבות להישמר לבין העדפות שאפשר לשנות. שם או נוסח מדויק צריכים להופיע במלואם. ציינו מה עדיין לא הוחלט; שדה חסר אינו רשות להשלימו בפרט מומצא, וייתכן שתידרש מכם הבהרה לפני הביצוע.
תוצאת „מחולל אנלוגיות” מופיעה ב־Vizify בתור טקסט או Markdown. אין כאן פרסום אוטומטי או העברה לשירות אחר. הטקסט מופיע בתוך השיחה, עם מבנה Markdown כשזה מועיל לקריאה. בדקו אותו ואז העתיקו בעצמכם למסמך או ליעד שבחרתם. הופעת טיוטה אינה שולחת אותה לאדם אחר ואינה מפרסמת בחשבון חיצוני. בחירת הגרסה הסופית וההחלטה להשתמש בה נשארות בידיכם.
ציינו מה לשנות ומה לשמור. ב„מחולל אנלוגיות” חשוב להמשיך להתייחס לנתוני המקור: המושג; הידע של הקוראים; היחס שצריך להסביר. ביצוע נוסף עשוי לצרוך עוד קרדיטים. בקשו תיקון באותה שיחה כשאפשר, וציינו פגם מסוים במקום לחזור על בקשה כללית לשיפור. הבדילו בין השינוי הדרוש לבין עובדות, ניסוחים וגבולות שצריכים להישמר. כך אפשר להבין למה התיקון מתייחס בלי לשנות בטעות פרט נכון או סגנון שכבר מתאים.
הכינו בקשה ובדקו אותה ב־Vizify, ובפרט את „המושג”. הביצוע מתחיל רק אחרי התחברות ושליחה לפי הרשאות החשבון והקרדיטים העדכניים. בדקו גם ששאר פרטי המקור הועברו בשלמותם ובהקשר הנכון. פתיחת היישום או הופעת בקשה מוכנה אינן מוכיחות שהמשימה בוצעה או שהתוצר נמסר. השליחה היא שלב נפרד; טיוטת הבקשה עצמה אינה ראיה להצלחת הביצוע.
בדקו התאמה של יחסים ולא רק דמיון חיצוני. לכל אנלוגיה צריכה להיות מגבלה מפורשת.