README

בפיתוח תוכנה, קובץ README הוא קובץ המכיל מידע על הקבצים האחרים בספרייה או בארכיון של תוכנת מחשב. זה בדרך כלל מדובר בקובץ טקסט פשוט שנקראREADME, Read Me, READ.ME, README.TXT, README.md (כדי לציין את השימוש ב- Markdown ), או README.1ST .

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

משמעות שם הקובץ בעברית הוא "קרא אותי".

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

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

בפרט, לתוכנות חופשיות ותוכנות קוד פתוח יש היסטוריה ארוכה של הוספת קובץ README; תקני הקידוד של GNU מעודדים לכלול את הקובץ כדי לספק "סקירה כללית של החבילה".

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

אתר האינטרנט הפופולרי לאירוח קוד מקור, GitHub מעודד מאוד יצירת קובץ README – אם אחד כזה קיים בספרייה הראשית (ברמה העליונה) של מאגר, הוא מוצג אוטומטית בעמוד הראשון של המאגר. בנוסף לטקסט רגיל, נתמכים גם פורמטים וסיומות קבצים שונים.

 כמונח כללי 
הביטוי "קובץ readme" משמש לעיתים גם באופן כללי, עבור קבצים אחרים עם מטרה דומה. לדוגמה, הפצות קוד המקור של חבילות תוכנה חינמיות רבות (במיוחד אלו העוקבות אחר תקני Gnits או אלו המיוצרות עם הכלים האוטומטיים של GNU) כוללות סט סטנדרטי של קובצי readme:
READMEמידע כלליAUTHORSקרדיטיםTHANKSתודותCHANGELOGיומן שינויים מפורט, מיועד למתכנתיםNEWSיומן שינויים בסיסי, מיועד למשתמשיםINSTALLהוראות התקנהCOPYING / LICENSEמידע על זכויות יוצרים ורישויBUGSבאגים ידועים והוראות לדיווח על באגים חדשיםCONTRIBUTING / HACKINGמדריך לתרומה לפרויקט
כמו כן בדרך כלל מופץ עם חבילות תוכנה קובץ שאלות נפוצות וקובץ TODO, המפרט שיפורים מתוכננים.

 לקריאה נוספת 




קטגוריה:תיעוד
קטגוריה:תוכנה