ต้นกำเนิดของ“ Readme”

32

ผู้คนเริ่มเขียนไฟล์ Readme เมื่อใด

ดูเหมือนว่าทุกโปรแกรมมีไฟล์นี้โดยไม่คำนึงถึงรูปแบบ

มีการใช้เอกสารครั้งแรกของเอกสารนี้หรือไม่?

documentation terminology history

— Mahmoud Hossam
แหล่งที่มา

19

มีเอกสารการใช้งานครั้งแรกของเอกสารประกอบซอฟต์แวร์หรือไม่ ...

— vines

1

เอกสารคู่มือซอฟต์แวร์ @vines! = Readme

— Mahmoud Hossam

แต่ Readme เป็นของ

— เถาวัลย์

2

@vines ฉันแน่ใจว่าเอกสารประกอบซอฟต์แวร์นำหน้าข้อตกลงการใช้ไฟล์ readme

— Mahmoud Hossam

21

ฉันไม่รู้การใช้งานครั้งแรกของบัญญัติ อาชีพไฟล์อธิบาย README เป็น:

การแนะนำตาของแฮกเกอร์นั้นรวมอยู่ในไดเรกทอรีระดับบนสุดของการแจกจ่ายแหล่ง Unix

ดังนั้นฉันจึงได้ดูต้นกำเนิดต้นยูนิกซ์บางต้นความเอื้อเฟื้อของต้น Unix (จัดทำโดยUnix Heritage SocietyและUnix Archive ) ไฟล์ README บางไฟล์ที่พบใน Unices ก่อนหน้านี้ ได้แก่ :

/ sys / source / lex / READMEจาก PWB 1.0 (กรกฎาคม 1977) - เร็วที่สุดที่ฉันสามารถหาได้
/ usr / doc / READMEจากฉบับที่เจ็ด (ม.ค. 1979) - เร็วที่สุดที่ฉันสามารถหาต้นไม้ต้นกำเนิดทั้งหมด
/ usr / doc / READMEจาก 3BSD (มีนาคม 1980) - เร็วที่สุดที่ฉันสามารถหา BSD ได้

ดังนั้นยินดีต้อนรับเมื่อวันที่กรกฎาคม 2520

— ทอมแอนเดอร์สัน
แหล่งที่มา

1

มันกลับไปเกินกว่า ITS น่าเสียดายที่ค่อนข้างยากที่จะหาสิ่งที่ประทับเวลาจริง ณ วันที่มีการแก้ไขครั้งล่าสุดเทียบกับวันที่เก็บถาวร README แรกนั้นน่าจะถูกสร้างขึ้นในช่วงปลายปี 1960 แต่ก็พิสูจน์ได้ว่าค่อนข้างเป็นงาน

— Tim Post

@Tim - README บนสแต็คการ์ด!

— Martin Beckett

ฉันพบหนึ่งตั้งแต่พฤศจิกายน 2517 และมีนาคม 2518: programmers.stackexchange.com/questions/96966/origin-of-readme/

— Hugo

10

ฉันเข้าเรียนระบบปฏิบัติการเมื่อปีที่แล้วและจำอาจารย์ของฉันบอกฉันว่าพวกเขามีไฟล์ README (ไฟล์จริงที่พิมพ์จริง) สำหรับการ์ด punch และ mag tape ของพวกเขาและสิ่งอื่นใดที่เป็น "โปรแกรม" ในเวลานั้นคุณต้องการจริงๆเพราะกระบวนการทำงานที่เกี่ยวข้องกับการสร้างวิ่งและทุกอย่างอื่น บางครั้ง README เหล่านี้ยังรวมถึงการพิมพ์จริงของวิธีการที่บัตรเจาะควรถูกเจาะเป็นรูปแบบของการตรวจสอบข้อผิดพลาดและการแก้จุดบกพร่อง

เห็นได้ชัดว่าการประชุมดังต่อไปนี้ตามระบบเก่าที่ว่า "กระดาษ" ที่แนบมากับหมัดบัตรคำสั่ง README พิมพ์ตัวพิมพ์ใหญ่บนหมวกมันมีคำแนะนำสำหรับการใช้งานและการโหลดของบัตรเจาะเข้าสู่ระบบ .

สำหรับการอ้างอิงเวลาสิ่งนี้น่าจะเป็นในยุค 60 แต่ระบบบัตรเจาะได้รับรอบตั้งแต่ปี 1700 สำหรับการควบคุม looms "อัตโนมัติ" ดังนั้นอาจแม้จะเก่าเท่าที่

— Jeff Langemeier
แหล่งที่มา

8

พบได้ที่alt.folklore.comกระทู้นี้:

ฉันเดิมพันเอกสารบางอย่างที่มาพร้อมกับหนึ่งในระบบปฏิบัติการ PDP-8 หรือแพคเกจซอฟต์แวร์อาจจะเก่าที่สุด

ที่เก่าแก่ที่สุดที่ฉันพบในเอกสาร PDP-10 คือ UCI LISP " READ.ME " จากเทปไลบรารี DECUS ที่ 4 พร้อมเวลาประทับ 27-Mar-1975 :

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

น่าเสียดายที่มินิ OS รุ่นก่อนหน้าหลายรุ่นไม่รองรับการประทับเวลา [เฉพาะ] ในโครงสร้างเทปและ / หรือดิสก์ไดเรคทอรีดังนั้นจึงเป็นการยากที่จะบอกได้ว่าเมื่อใดที่เอกสารถูกแก้ไขครั้งล่าสุด

ไฟล์ดังกล่าวไม่เพียง แต่มีเวลา 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 ฉันพบREADME.TXTรุ่นก่อนหน้านี้ตั้งแต่วันที่ 27 พฤศจิกายน 2517 ทั้งเวลาประทับและลงนามในไฟล์ :

[README.TXT เป็นไฟล์ DOC สำหรับ SPICE / SINC / SLIC]

เทปที่ไม่ปลอดภัยนี้ประกอบด้วยโปรแกรมวิเคราะห์วงจร:
    SPICE SINC and SLIC
อธิบายไว้ในแอปพลิเคชั่นซอฟต์แวร์ Bulletin เล่มที่ 4

ความต้องการ:

SPICE ต้องการ FORTRAN-10 เวอร์ชัน 4 เนื่องจากมีการใช้ข้อมูล Holerith ที่ปรับค่าแล้วด้านขวา ดำเนินการในประมาณ 47K

[ ... ]

มันยังรวมถึงไฟล์นี้ FOROTS ที่จะไปกับ SAVes และแหล่งที่มาสำหรับ SECOND.MAC ซึ่งเป็นขั้นตอนการกำหนดเวลา SPICE แบ่งออกเป็นสามส่วน: 1SPICE สำหรับ 2 และ 3

มีเอกสารที่พิมพ์ออกมาเพื่ออธิบายแต่ละโปรแกรม สิ่งเหล่านี้รวมอยู่ในแพ็คเก็ต DECUS เอกสารและโปรแกรมได้รับการพัฒนาโดยแผนก EE ของ Univ of Calif. ที่ Berkley บน CDC 6400 ยกเว้นการแปลง FORTRAN เป็น DECsystem-10 ไม่มีการเปลี่ยนแปลงใด ๆ ในโปรแกรม สำหรับข้อมูลการทดสอบ SLIC และ SINC ได้แสดงการเปลี่ยนแปลงเล็กน้อยเมื่อเทียบกับ 6400 SPICE จะไม่แสดงการเปลี่ยนแปลง

โชคดี! แอชลีย์เกรย์สัน 27-NOV-74

[สิ้นสุด README.TXT]

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

— ฮิวโก้
แหล่งที่มา