LDP每周新闻
2001-03-06

过时的HOWTO指南 (以调制解调器HOWTO为例)

对于Linux来说，过时（陈旧）的文档是一个主要问题。这在Linux文档项目（LDP）中也是一个问题。文档过时的众所周知的原因是文档作者有时不会足够频繁地修订他们的文档。但即使他们经常修订，搜索信息的人们也可能找不到最新的版本。

原因如下。尽管Linux文档项目（LDP）在其超过200个镜像站点上拥有其文档的最新版本，但还有数百个其他站点也承载着LDP文档。不幸的是，其中大多数都包含过时的文档。为什么人们不直接访问镜像站点而避开其他站点呢？原因是许多人使用互联网上可用的众多搜索引擎之一来搜索有关Linux的信息。很可能，这样的搜索引擎会找到过时的Linux文档。虽然LDP站点有一个用于搜索LDP站点的搜索引擎，但搜索整个Web通常是有利的，因为除了LDP的文档之外，还有许多其他文档可用。但这样做很可能会找到过时的文档。

假设有人使用搜索引擎找到了LDP HOWTO指南。他们不能只查看文档的日期，然后点击链接到镜像站点的链接，该镜像站点将拥有最新的文档吗？不幸的是，这不太容易做到。人们通常用搜索引擎找到的不是整个文档，而只是文档的章节。html文档通常被分成章节，以便它们能够快速下载。

每个章节都不包含版本或日期信息（也许应该包含）。虽然文档中可能有一个章节包含指向最新版本的链接，但它不太可能在用搜索引擎找到的章节中。要找到这样的链接（如果存在），首先需要点击“目录”链接以转到目录页。然后，人们可能会浏览目录，尝试找到指向另一个章节的链接，该章节本身可能包含指向最新版本的链接。这既不简单，也不确定，也不快速，因此很少有读者会这样做。

我做了一个快速调查，以找出互联网上有哪些版本的调制解调器HOWTO指南。以下是结果：（最后一列是根据2001年3月2日Google的数据，网络上站点的数量。）

情况并不像上面显示的那么糟糕，因为在某些情况下，Google没有最新的信息：站点已更新，但Google不知道，或者站点可能已失效。但抽查表明，大约80%的站点仍然如列表所示存在。那些应该有v0.12版本的站点经常有最新版本。

在少数情况下，存在重复计数，因为某些站点以多种格式提供HOWTO指南。此外，少数站点在名为“archives”、“old”等的目录中包含过时的HOWTO指南。这没问题，因为它们被正确分类。

在另一方面，情况甚至比上面描述的更糟，因为调制解调器HOWTO指南是从串行HOWTO指南分支出来的。超过200个旧版本的串行HOWTO指南（在调制解调器HOWTO指南的第一个版本之前）仍然在互联网上。它们都包含关于调制解调器的相当过时的信息。

以下是我如何进行搜索的一些细节。我使用google.com进行搜索，搜索词为：Modem-HOWTO “modulation details” v0.xx，其中xx = 00、01、02等。““modulation details””这个短语来自目录，以便始终选择HTML目录文件（对于拆分的HTML-HOWTO指南）。这是必需的，因为v0.xx有时也在第1章中，并且用于让读者可以点击链接到LDP以查看他们是否拥有最新版本。如果省略“modulation details”，则会存在重复计数。此外，“modulation details”还消除了对HOWTO指南列表/目录的点击。关于我如何做到这一点还有更多细节，但它们不是普遍感兴趣的，因此省略了。

因此，互联网上存在大量过时的LDP文档（和其他文档）版本。减少这个问题的一种方法是在许可证中加入一些要求，以便当文档过时时，必须明确标记为过时。这种标记需要在点击文档之前看到。但是如何确保这一点呢？可能有所帮助的是在文档名称中添加一个后缀，以指示它已过时。