web-dev-qa-db-ja.com

「Readme」の起源

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

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

この文書の文書化された最初の使用はありますか？

documentationterminologyhistory
32
Mahmoud Hossam

私は正規の最初の使用を知りません。 用語ファイル は、READMEを次のように説明しています。

Unixソース配布の最上位ディレクトリに伝統的に含まれているハッカーの目の紹介

したがって、私は The Unix Tree （ nix Heritage Society および nix Archive によって提供）の厚意により、初期のUNIXソースツリーを調べました。 。初期のユニックスで見つかったいくつかのREADMEファイルは次のとおりです。

だから、1977年7月の進歩は大歓迎です！

21
Tom Anderson

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

慣例は明らかに古いシステムにも従い、すべてのパンチカードで "reem"の紙にステートメントREADMEがキャップに印刷されて）が添付され、これにはすべての使用説明書がありました。パンチカードをシステムにロードします。

時間の参照として、これは60年代でした。しかし、1700年代から「自動化された」織機を制御するためのパンチカードシステムが存在していたため、おそらくそれと同じくらい古いかもしれません。

10
Jeff Langemeier

これで見つかりました alt.folklore.computers スレッド：

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

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

編集：1974年11月27日の以前のREADME.TXTを見つけたPDP-10アーカイブを参照します timestamp と署名の両方 ファイル ：

[README.TXTはDOC SPICE/SINC/SLICのファイル）

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

    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パケットに含まれています。ドキュメントとプログラムは、大学のE.E.部門が独自に開発したものです。 FORCを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

8
Hugo