הכותב הטכני הדיגיטלי

ה-B AI משנה יותר מאשר את הדרך שבה הכותבים הטכניים כותבים תוכן. זה מחדש את הדרך בה אנחנו חוקרים, יוצרים, מבנים, בודקים, מתחזקים ומודדים דוקומנטציה, תוך שינוי התפקיד של הכותב הטכני עצמו.המפגש הזה יחקור דרכים מעשיות שבהן כותבים טכניים משלבים AI בתהליכי העבודה שלהם, החל מכלים ואמצעים מבוססי AI לטיוב דוקומנטציה ועד גישות חדשות לארגון ולתחזוקת תוכן.דובר מאושראנה טרוגר, דוקטור כותבת טכנית בכירה בבייר שיחה: בניית מיומנות סיווג Diátaxis עבור Docs-as-Code תיאור: במאגרי Docs-as-Code פנימיים, דוקומנטציה נוטה לגדול באופן אורגני, ולא בעיצוב. דפים נוספו היכן שנוח ולא היכן שהם שייכים, והתוצאה היא מבנה שטוח ולא מסוגל שמתן חיבור מוחלט שלא מבינים לחלוטין. מעברי פלטפורמה מחמירים את המצב: כל היררכיה שעמדה קודם לכן קורסת חלקית, והתוכן מגיע כבצ_batch. העלות היא על כולם - הקוראים מאבדים זמן במצב הלא נכון, הכותבים מאבדים ביטחון לגבי היכן תרומתם מתבצעת, וכלים מבוססי AI מאבדים דיוק כי אותות מעורבים מייצרים פלטים מעורבים.אחת מהאפשרויות היא לחדש מחדש את מאגר הנתונים כך שיהיה קל יותר למצוא מידע, קל יותר לתחזק, ובפוטנציה קל יותר לצריכה על ידי AI. השיחה הזו עוסקת בבניית מיומנות AI שמסווגת דפי דוקומנטציה בהתאם למסגרת Diátaxis - מדריך, איך לעשות, הסבר והפניה - ועוד סוג חמישי, ניווט, נוסף כדי לטפל במוקדי הניווט שכל מאגר אמיתי מכיל. נבחן כיצד מיומנות זו מאורגנת בשלושה קבצים עצמם, את זרם העבודה בן ארבעת השלבים שהיא נוהגת בו (קריאה, סיווג, חלוקה, ניווט), ולמה היא מייצרת רמת ביטחון מאת אותות המפוזרים במקום פסק דין של pass/fail - כשביטחון נמוך פועל כאות דוקומנטציה מעורבת.מתאימה לכותבים טכניים בכל הרמות; חלקים על עיצוב מיומנויות והחלטות מגיעים לעומק עבור מתרגלים מנוסים. יסודות מסגרת Diátaxis ודוגמאות יכוסו בקצרה, ואם אתה רוצה להוציא את המרב מהשיחה הזו, אני ממליץ לעיין במסגרת Diátaxis מראש: https://diataxis.fr/start-here/פרנסס ליו שותפה ומייסדת, Promptlessשיחה: מה סוכני AI עושים לא נכון כאשר הם כותבים דוקומנטציהתיאור: אנו בודקים באופן קבוע סוכני גבול (Claude Code, Codex, ו-OpenCode עם מודלים פתוחים) על משימות דוקומנטציה. ההצעות בדרך כלל חוזרות מלוטשות ועקביות, אבל הכישלונות שלהם התרחשו לפני הכתיבה: להחליט אם שינוי צריך דוקומנטציה בכלל, להבין למי הדוקומנטציה הייתה מיועדת, לבחור באיזה עמוד השינוי שייך, ולענות מה הקורא צריך לעשות במקום לתאר מה הפונקציה עושה.נעבור על אילו סוכנים מחזיקים באילו סוגי משימות, מה ההקשר שמעלה את סיכוי הצלחתם, וכיצד לבדוק את הפלט שלהם כך שהכישלונות השקטים לא יגיעו לקוראים שלך. תעזוב עם רשימה לבדיקה למה למסור לסוכן, ומה לבדוק כאשר הוא מחזיר עבודה.הלנה ג'רני ראש חוויית המידע ב-StreetLight Dataשיחה: ארכיטקטורת מידע עבור הקהל של AIתיאור: מה דרוש לתוכן להיבלע על ידי AI כדי לאפשר חוויית משתמש אופטימלית. היכן שהתוכן ואדריכלות ההקשר מצטלבים וכיצד לנהל את צינור המידע כדי להתמודד עם הצרכים והמגבלות של LLMs.עוד פרטים יגיעו.