古い文書を使用または無視する経験的な方法[閉じる]

古い文書を使用または無視する経験的な方法[閉じる]

検索結果としてインポートしたり、参照リンクを介して生成されたばかりの文書に頻繁に遭遇します。数ヶ月、数年。時々、文書は次のように表示されます。廃止または他の不適切な状況ですが、必ずしもそうではありません。

しかし、それが歴史的であっても、ある程度まではまだ適用されます。 *nix環境の変化するダイナミクスの全体像を描くことは可能ですか?特定の地域が変更される可能性(または将来変更される予定)はどのくらいですか?どのくらい変化し、どのくらいの頻度で変更されますか?

この質問は次のようになります。 Linux文書化プロジェクトはどれほど最新で関連性がありますか?しかし、より一般的です。私が望む基準は次のとおりです。

(ただの例であり、実際とは何の関係もありません)

  • 「主なファイルシステム構造は25年間変わらず、POSIXが保証するように今後25年間も変わらないでしょう。年齢」

  • 「CライブラリのAPIは数ヶ月に1回ずつ変わります。特にネットワーキングスペースでは非常に進化しているからです。しかし、標準と見なされているコア機能は、それ以降は変わりません。ホイールの再発明だ」

間接的に、この質問は Q&A サイト (このサイトなど) のヒントが時間が経ってもどれくらい有効かを尋ねます。

ベストアンサー1

あなたが投稿した2つの引用は、「文書化」ではなく誰かの意見のように聞こえます。

標準は動く目標です。人々はそれを実装することを目指すかもしれませんが、数年ごとに更新され、意図的に標準に従わない拡張とケースが常にあります。これは、「適切な標準」と「一時的な標準」の両方に適用されます。

それでもPOSIXのような標準は変わります。ゆっくり時間が経つにつれて有用で需要が高く、広く受け入れられているため、新しいものが導入されますが、古いものは廃止されたため廃止されます。そのため、U&Lの一部の人々は、一部のシェルエントリ(たとえば)がPOSIXと互換性がなく、特定のツール実装の特定のバージョンでのみ動作する(場合によっては動作しない)ことを指摘したいと思います。これは、GNUや他のベンダーが提供する特定の実装よりも回答を効率的にする方法です。

システムのインターフェースとツールに関する文書を見つけるのに最適な場所は、常にオンラインマニュアルです。あなたのシステムで、使用中のソフトウェアと一緒に配布することができる他のすべての形式の文書。

sed特定のフラグやgrepユーティリティが何をしているのか、Perlでどのように使用されているのかをWebで検索できますが、Getopt::Longこれは実際のユーティリティやライブラリと共にインストールされるマニュアルです。あなたのシステムでこれは明確な文書です。

過去の文書が同じ既存のシステムを実行している人に役立つ可能性があることは否定できませんが、文書は通常、この記事が作成された時点のシステムまたはツールに固有のものです。たとえば、新しいOpenBSD 5.9システムを使用していて、sudo基本システムにいる必要があるというWebページを読んでいますが、なぜ機能しないのか疑問に思っている場合は、次の記事をお読みください。afterboot(8)手動(プロンプトに従って)説明インストールしたばかりのシステム。これはあなたに言うでしょうdoas便利です。

私のポイントは、Unixがどこに行くのか、どこから来たのかは重要ではないということです。あなたはそれを作動させる機械の前にいます、ここで最新のドキュメントを見つけることができます。

ホスト間で電子メールを交換するためにUUCPを設定する方法、またはPostgreSQLでデータベース複製を実行する方法を説明するものをWebで見る場合は、ドキュメントの対象読者が誰であるか、これらのツールの目的と動作が何であるかを考慮する必要があります。時間によって理由は異なる場合があります。システムのマニュアルは次のとおりです。あなた、対象のお客様は、システムの使い方を目の前で理解したいユーザーです。

私の答えが主題から少し外れたものであれば申し訳ありませんが、最近私がたくさん考えている部分です。

おすすめ記事