「Readme」の由来

32

人々はいつReadmeファイルを書き始めましたか？

フォーマットに関係なく、ほとんどすべてのプログラムにこのファイルがあるようです。

このドキュメントの最初の使用が文書化されていますか？

documentation  terminology  history 
— マフムード・ホッサム
ソース
19
ソフトウェア文書の最初の使用が文書化されていますか？
— ...-ブドウ
1
@vinesソフトウェアドキュメント！= Readme
— Mahmoud Hossam
しかし、Readmeはに属します。
— ブドウ
2
@vinesソフトウェアのドキュメントは、readmeファイルを使用する慣習に先行するはずです。
— マフムードホッサム

回答:

21

正規の最初の使用法は知りません。ジャーゴンファイルは、 READMEなどを説明します。

伝統的にUnixソースディストリビューションのトップレベルディレクトリに含まれていたハッカーの紹介

そこで、Unix Tree（Unix Heritage SocietyとUnix Archiveから提供）の好意により、初期のUnixソースツリーをいくつか見てきました。初期のユニックスで見つかったいくつかのREADMEファイルには、

したがって、1977年7月の進歩は大歓迎です！

— トム・アンダーソン
ソース
1
それはITSを超えていますが、残念なことに、最後に変更された日付とアーカイブされた日付で実際にタイムスタンプされたものを見つけるのはかなり困難です。最初のREADMEは1960年代後半に作成された可能性がありますが、それを証明するのはかなりの作業です。
— ティムポスト
@Tim-パンチカードのスタックに関するREADME！
— マーティンベケット
私は1974年11月と1975年3月から1を見つけました：programmers.stackexchange.com/questions/96966/origin-of-readme/...
— ヒューゴ
10

昨年、私はオペレーティングシステムクラスを受講しましたが、教授が、パンチカードや磁気テープなど、すべての「プログラム」に関するREADME（実際の物理的な印刷ファイル）を持っていると言っていたことを思い出します。当時は、作成、実行、およびその他すべての処理に関与する膨大なプロセスのため、本当に必要でした。これらのREADMEには、エラーチェックとデバッグの形式として、パンチカードがどのようにパンチされることになっているかの実際のプリントアウトも含まれることがあります。

慣例は明らかに古いシステムにも従い、すべてのパンチカードには紙の「連句」が付いており、キャップにREADMEという文が印刷されています。 。

時間の基準として、これは60年代にあったでしょう。しかし、パンチカードシステムは1700年代から「自動化された」織機を制御するために使用されてきたため、おそらくそれと同じくらい古いものです。

— ジェフ・ランゲマイヤー
ソース
8

このalt.folklore.computersスレッドを介して見つかりました：

PDP-8オペレーティングシステムまたはソフトウェアパッケージの1つに付随するドキュメントがおそらく最も古いものになると確信しています。

PDP-10アーカイブで見つかった最も古いものは、4番目のDECUSライブラリテープからのUCI LISP " READ.ME "で、タイムスタンプは 1975年3月27日です。

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

残念ながら、以前のミニOSの多くは、テープやディスクのディレクトリ構造で[一意の]タイムスタンプをサポートしていないため、ドキュメントが実際に最後に編集された時期を判断するのは困難です。

ファイルには1975年3月27日のタイムスタンプがあるだけでなく、ファイル自体に手作業で署名され、日付が付けられています。

                    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を 1974年11月27日、両方からのタイムスタンプとに署名したファイル：

[README.TXTはSPICE / SINC / SLICのDOCファイルです]

このフェールセーフテープには、回路解析プログラムが含まれています。

    SPICE SINC and SLIC

Applications Software Bulletin Volume 4で説明されています。

要件：

SPICEでは、右調整されたホレリスデータを使用するため、FORTRAN-10バージョン4が必要です。約47Kで実行されます。

[...]

また、このファイル、SAVesとともに使用するFOROTS、およびタイミングルーチンであるSECOND.MACのソースも含まれています。SPICEは、1SPICE.FOR、2、3の3つの部分に分かれています。

各プログラムを説明する印刷文書があります。これらはDECUSパケットに含まれています。ドキュメントとプログラムは、大学のEE部門によって元々開発されました。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

— ヒューゴ
ソース
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.