"Readme" की उत्पत्ति

32

लोगों ने रीडमी फाइलें लिखना कब शुरू किया?

ऐसा लगता है कि इस प्रारूप की परवाह किए बिना सभी कार्यक्रमों में बहुत अधिक है।

क्या इस दस्तावेज़ का कोई प्रथम उपयोग है?

documentation terminology history

— महमूद होसम
स्रोत

19

क्या सॉफ्टवेयर डॉक्यूमेंटेशन का कोई पहला दस्तावेज इस्तेमाल किया गया है? ...

— बेल्स

1

@vines सॉफ्टवेयर डॉक्यूमेंटेशन! = Readme

— महमूद

लेकिन Readme से संबंधित है।

— दाख

2

@vines मुझे यकीन है कि सॉफ्टवेयर प्रलेखन एक रीडमी फ़ाइल का उपयोग करने के सम्मेलन से पहले है।

— महमूद होसाम

21

मैं एक विहित पहले उपयोग का पता नहीं है। शब्दजाल फ़ाइल README के रूप में वर्णन करता है:

हैकर की आंख का परिचय पारंपरिक रूप से यूनिक्स स्रोत वितरण की शीर्ष-स्तरीय निर्देशिका में शामिल है

इसलिए मुझे कुछ शुरुआती यूनिक्स स्रोत पेड़ों के माध्यम से एक नज़र मिली, जो कि यूनिक्स ट्री के सौजन्य से है ( यूनिक्स हेरिटेज सोसाइटी और यूनिक्स आर्काइव द्वारा प्रदान की गई है )। प्रारंभिक यूनियनों में पाई गई कुछ README फाइल में शामिल हैं:

PWB 1.0 (जुलाई 1977) से / sys / source / lex / README - सबसे पहले मैं पा सकता था
/ usr / doc / README सातवें संस्करण से (जनवरी 1979) - जल्द से जल्द मैं पूरे स्रोत पेड़ के लिए मिल सकता है
/ usr / doc / README 3BSD (मार्च 1980) से - सबसे पहले मैं बीएसडी के लिए खोज सकता था

इसलिए, जुलाई 1977 को अग्रिमों का स्वागत है!

— टॉम एंडरसन
स्रोत

1

यह ITS से परे वापस चला जाता है, दुर्भाग्य से यह वास्तव में समय को उस तारीख पर मुहर लगाने के लिए मुश्किल है जो इसे अंतिम बार संशोधित किया गया था, बनाम यह जिस तारीख को संग्रहीत किया गया था। पहला README संभवतः 1960 के दशक के अंत में बनाया गया था, लेकिन यह साबित करना काफी कठिन काम है।

— टिम पोस्ट

@Tim - पंच कार्ड के ढेर पर एक README!

— मार्टिन बेकेट

मुझे नवंबर 1974 और मार्च 1975 से एक मिला: प्रोग्रामर.स्टैकएक्सचेंज.

— ह्यूगो

10

मैंने पिछले साल एक ऑपरेटिंग सिस्टम की क्लास ली और अपने प्रोफेसर को यह बताते हुए याद किया कि उनके पास सभी पंच कार्ड और मैग टेप के लिए README (वास्तविक भौतिक मुद्रित फाइलें) थीं और बहुत कुछ और भी जो "प्रोग्राम" था। उस समय आपको वास्तव में एक आवश्यक प्रक्रिया की वजह से एक ऐसी प्रक्रिया की आवश्यकता थी जो निर्मित, भाग-दौड़ और अन्य सभी चीजों को प्राप्त करने से जुड़ी थी। इन README के कभी-कभी वास्तविक प्रिंटआउट भी शामिल होते हैं कि कैसे पंच कार्ड को त्रुटि जाँच और डीबगिंग के रूप में छिद्रित किया जाना चाहिए था।

यह सम्मेलन स्पष्ट रूप से पुरानी प्रणाली का अनुसरण करता है जिसमें सभी पंच कार्डों के साथ एक "रीम" कागज़ को उस पर छपे हुए कैप्स में स्टेटमेंट के साथ संलग्न किया गया था, इसमें सिस्टम में पंच कार्ड के उपयोग और लोडिंग के सभी निर्देश थे। ।

एक समय के संदर्भ के लिए, यह 60 के दशक में रहा होगा। लेकिन छिद्रित कार्ड प्रणाली "स्वचालित" करघे के नियंत्रण के लिए 1700 से है, इसलिए शायद यह भी उतना ही पुराना है।

— जेफ़ लैंगमेयर
स्रोत

8

इस alt.folklore.compoints धागे के माध्यम से मिला :

मैं पीडीपी -8 ऑपरेटिंग सिस्टम या सॉफ्टवेयर पैकेज में से एक के साथ कुछ दस्तावेज़ को दांव लगा रहा हूं जो शायद सबसे पुराना होगा।

सबसे पुराना जो मुझे पीडीपी -10 अभिलेखागार में मिला है, वह 4-DECUS लाइब्रेरी टेप से UCI LISP " READ.ME " है, जिसमें 27-Mar-1975 का टाइमस्टैम्प है :

http://pdp-10.trailing-edge.com/decuslib10-04/index.html

दुर्भाग्य से, पहले के कई मिनी ओएस टेप और / या डिस्क डायरेक्टरी स्ट्रक्चर में [यूनिक] टाइमस्टैम्प का समर्थन नहीं करते हैं, इसलिए यह बताना मुश्किल है कि कोई डॉक्यूमेंट वास्तव में आखिरी बार कब संपादित किया गया था।

न केवल फ़ाइल में 27 मार्च 1975 टाइमस्टैम्प है, बल्कि यह फ़ाइल में ही हस्ताक्षरित और दिनांकित है :

                    UCI LISP

                    Random Notes

                    [...]

  Should  problems  arise  with   this   system,  please
  communicate  them  to  the  Department  of  Information and
  Computer Science at UCI;  they will be directed to whomever
  is currently managing the UCI LISP system.

            William J. Earl
            Department of Information and Computer Science
            University of California
            Irvine, California

            27 March 1975

संपादित करें: PDP-10 अभिलेखागार के आसपास ब्राउज़ करना मुझे 27 नवंबर 1974 से पहले README.TXT मिला , दोनों टाइमस्टैम्प और फ़ाइल में हस्ताक्षरित :

[README.TXT SPICE / SINC / SLIC के लिए DOC फाइल है]

इस असफल टेप में सर्किट विश्लेषण कार्यक्रम शामिल हैं:
    SPICE SINC and SLIC
एप्लीकेशन सॉफ्टवेयर बुलेटिन वॉल्यूम 4 में वर्णित है।

आवश्यकताएँ:

SPICE को सही समायोजित होलेरिथ डेटा के उपयोग के कारण FORTRAN-10 संस्करण 4 की आवश्यकता है। लगभग 47K में निष्पादित करता है।

[...]

इसमें यह फ़ाइल, SAVes के साथ जाने के लिए FOROTS और SECOND.MAC के लिए स्रोत, टाइमिंग रूटीन भी शामिल है। स्पाइस को तीन भागों में विभाजित किया गया है: 1SPICE.FOR, 2 और 3।

प्रत्येक कार्यक्रम का वर्णन करने के लिए एक मुद्रित दस्तावेज़ है। ये DECUS पैकेट में शामिल हैं। प्रलेखन और कार्यक्रम मूल रूप से यूनिव के ईई विभाग द्वारा विकसित किए गए थे। एक सीडीसी 6400 पर बर्कले में कैलिफ़ोर्निया के। फोरट्रान को DECsystem-10 में बदलने के अलावा कार्यक्रमों में कोई बदलाव नहीं किया गया है। परीक्षण डेटा के लिए एसएलआईसी और एसआईएनसी ने 6400 के संबंध में थोड़ी भिन्नता दिखाई है, स्पाइस कोई भिन्नता नहीं दिखाता है।

सौभाग्य! एशले ग्रेसन 27-एनओवी -74

[README.TXT का अंत]

http://pdp-10.trailing-edge.com/decus_20tap3_198111/01/decus/20-0079/readme.txt.html

— ह्यूगो
स्रोत