Nguồn gốc của hoàng tử Readme


32

Khi nào mọi người bắt đầu viết các tập tin Readme?

Dường như khá nhiều chương trình có tệp này, bất kể định dạng.

Có bất kỳ tài liệu sử dụng đầu tiên của tài liệu này?


19
Có tài liệu nào sử dụng tài liệu phần mềm lần đầu không? ...
dây leo

1
Tài liệu phần mềm @vines! = Readme
Mahmoud Hossam

Nhưng Readme thuộc về.
dây leo

2
@vines Tôi chắc chắn rằng tài liệu phần mềm có trước quy ước sử dụng tệp readme.
Mahmoud Hossam

Câu trả lời:


21

Tôi không biết về việc sử dụng đầu tiên kinh điển. Các Jargon File mô tả các README như:

Theo truyền thống, phần giới thiệu về mắt của hacker bao gồm trong thư mục cấp cao nhất của bản phân phối nguồn Unix

Vì vậy, tôi đã xem qua một số cây nguồn unix đầu tiên, với sự hỗ trợ của Cây Unix (được cung cấp bởi Hội di sản UnixLưu trữ Unix ). Một số tệp README được tìm thấy trong các thông báo sớm bao gồm:

  • / sys / source / lex / README từ PWB 1.0 (tháng 7 năm 1977) - sớm nhất tôi có thể tìm thấy
  • / usr / doc / README từ Phiên bản thứ bảy (tháng 1 năm 1979) - sớm nhất tôi có thể tìm thấy cho toàn bộ cây nguồn
  • / usr / doc / README từ 3BSD (tháng 3 năm 1980) - sớm nhất tôi có thể tìm thấy cho một BSD

Vì vậy, những tiến bộ vào tháng 7 năm 1977 được chào đón!


1
Nó quay trở lại ngoài ITS, thật không may, thật khó để tìm thấy thứ gì đó thực sự được đóng dấu vào ngày nó được sửa đổi lần cuối, so với ngày nó được lưu trữ. README đầu tiên có khả năng được tạo ra vào cuối những năm 1960, nhưng chứng minh rằng đó là một nhiệm vụ khá khó khăn.
Tim Post

@Tim - một README trên một chồng thẻ đục lỗ!
Martin Beckett

Tôi tìm thấy một từ tháng 11 năm 1974 và tháng 3 năm 1975: programmers.stackexchange.com/questions/96966/origin-of-readme/...
Hugo

10

Tôi đã tham gia một lớp Hệ điều hành vào năm ngoái và nhớ rằng giáo sư của tôi nói với tôi rằng họ đã có README (tệp in thực tế) cho tất cả các thẻ đục lỗ và băng mag và hầu hết mọi thứ khác là "chương trình". Vào thời điểm đó, bạn thực sự cần một thứ vì quy trình lao động có liên quan đến việc tạo ra, chạy và mọi thứ khác. Đôi khi các README này cũng bao gồm các bản in thực tế về cách các thẻ đục lỗ được cho là được đục lỗ như một hình thức kiểm tra lỗi và gỡ lỗi.

Quy ước dường như cũng tuân theo hệ thống cũ ở chỗ với tất cả các thẻ đục lỗ, một "tờ giấy" được đính kèm với tuyên bố README in trên mũ, điều này có tất cả các hướng dẫn sử dụng và nạp thẻ đục lỗ vào hệ thống .

Để tham khảo thời gian, điều này sẽ có trong những năm 60. Nhưng hệ thống thẻ đục lỗ đã có từ những năm 1700 để kiểm soát máy dệt "tự động", do đó thậm chí có thể cũ như thế.


8

Tìm thấy thông qua chủ đề alt.folklore.computers này :

Tôi đang đặt cược một số tài liệu đi kèm với một trong các hệ điều hành hoặc gói phần mềm PDP-8 có thể sẽ là bản cũ nhất.

Tài liệu cũ nhất tôi tìm thấy trong kho lưu trữ PDP-10 là UCI LISP " READ.ME " từ băng thư viện DECUS thứ 4, với dấu thời gian từ 27 tháng 3 năm 1975 :

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

Thật không may, nhiều hệ điều hành mini trước đó không hỗ trợ dấu thời gian [duy nhất] trong cấu trúc thư mục băng và / hoặc đĩa, vì vậy thật khó để biết khi nào tài liệu thực sự được chỉnh sửa lần cuối.

Tệp không chỉ có dấu thời gian ngày 27 tháng 3 năm 1975 mà còn được ký và ghi ngày tháng trong chính tệp :

                    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

Chỉnh sửa: duyệt qua Lưu trữ PDP-10 Tôi tìm thấy README.TXT trước đó từ ngày 27 tháng 11 năm 1974, cả dấu thời gian và đăng nhập vào tệp :

[README.TXT là tệp DOC cho SPICE / SINC / SLIC]

Băng không an toàn này chứa các chương trình phân tích mạch:

    SPICE SINC and SLIC

được mô tả trong Bản tin phần mềm ứng dụng Tập 4.

yêu cầu:

SPICE yêu cầu FORTRAN-10 phiên bản 4 vì sử dụng dữ liệu Holerith được điều chỉnh đúng. Thi công trong khoảng 47K.

[...]

nó cũng bao gồm tệp này, các FOROTS đi cùng với SAVes và nguồn cho SECOND.MAC, thói quen thời gian. SPICE được chia thành ba phần: 1SPICE.FOR, 2 và 3.

Có một tài liệu in để mô tả từng chương trình. Chúng được bao gồm trong gói DECUS. Các tài liệu và chương trình được phát triển về mặt tôn giáo bởi bộ phận EE của Univ. của Calif. tại Berkley trên CDC 6400. Ngoại trừ việc chuyển đổi FORTRAN sang DECsystem-10, không có thay đổi nào được thực hiện đối với các chương trình. Đối với dữ liệu thử nghiệm SLIC và SINC đã cho thấy một sự thay đổi nhỏ so với 6400, SPICE cho thấy không có biến thể.

Chúc may mắn! Ashley Grayson 27-NOV-74

[kết thúc README.TXT]

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

Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.