תיעוד

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

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

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

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

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

תיעוד במדעי המחשב
סוגים
להלן סוגים נפוצים של תיעוד תוכנה:

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

להלן סוגים נפוצים של תיעוד חומרה ושירותים:


 גיליון נתונים למערכות טכנולוגיית המידע (למשל, שרתים, מתגים)
  וספריית התשתיות של מערכות המידע

קישורים חיצוניים

  IEEE Professional Communication Society
  Information & Documentation List of selected tools

הערות שוליים

קטגוריה:מידע
קטגוריה:תקשורת כתובה
קטגוריה:שיטות תקשורת