On Wed, 19 May 2004 23:57:18 -0500, Sheldon Rampton sheldon.rampton@verizon.net wrote:
The difference between [[XFree86]] and [[XFree86 logfile]] is that [[XFree86]] really *is* an "encyclopedia" article. It begins with a lead paragraph that explains, even to a relative novice, what XFree86 is: "an open source implementation of the X Window System.." By contrast, [[XFree86 logfile]] begins as follows:
When XFree86 starts, it creates a logfile which contains information about what happened when XFree86 started. It contains information about what modules were loaded, which color depth that is used etc. The file is especially useful when something goes awry, as reading it can help you find exactly what went wrong.
This reads like a technical manual, not an encyclopedia. As a lead paragraph, it leaves something to be desired.
I've added a new lead sentence, which I think is an improvement.