|
|
Does this document make any sense at all? No, it doesn't. It's written backwards in reverse chronological form, to demonstrate how it obfuscates things. Try this version
These are only two examples. In almost every case, you'll find something similar. You'd be surprised to read a book or a magazine which presents the material in this sequence. Why do people do it in web pages? My guess is because the tools at their disposal are inadequate for reading a normally sequenced document. That's not the document's fault, though; the tools need fixing, not the documents.
There are more mainstream examples, of course. Like all others, my bank (ANZ) sends me statements of account, in my case monthly. They follow the time-honoured tradition of chronological listing. ANZ also offers a web-based “Internet Banking” service. Here the same information is presented in reverse chronological order—only. Sure, there are enough afficionados of reverse chronological listings that it's reasonable to cater for them. But why offer only a format that contradicts the standard format that the bank uses elsewhere?
In the example above, the first of the original entries above refers to modules, but they're not defined until the following entries: it's a forward reference. Yes, you could easily guess. But you have to guess, and the more such references there are, the more confusing the document becomes.
So what makes the separation at a paragraph level ideal? Nothing, I claim. The obvious intention of such a document is to present the most recent information first, and older information later. But what's the advantage? You still lose the continuity that a document in natural order would have. At the very least, this implies that the older information is less important. I contend that you can't understand something properly by looking at what has happened recently.
20041201: You need to include either ath_rate_onoe or ath_rate_amrr when configuring the kernel. The ath driver has been updated to split the tx rate control algorithm into a separate module.
It gradually becomes more intelligible if only the sentences are transposed:
.kernel the configuring when_amrr_rate ath or_onoe_rate ath either include to need You. module separate a into algorithm control rate tx the split to updated been has driver ath: The 20041201
At a word level it's almost equally unintelligible:
.lenrek eht gnirugifnoc nehw rrma_etar_hta ro eono_etar_hta rehtie edulcni ot deen uoY .eludom etarapes a otni mhtirogla lortnoc etar xt eht tilps ot detadpu neeb sah revird hta ehT :10214002
Here we have three entries relating to wireless LAN support. The document format places a new entry above the previous entries; but they're entries. Clearly reversing the text at a smaller level would be unintelligible. For example, the last entry reversed at a character level is:
20041219: Auto-loading of ancillary wlan modules such as wlan_wep has been temporarily disabled; you need to statically configure the modules you need into your kernel or explicitly load them prior to use. Specifically, if you intend to use WEP encryption with an 802.11 device load/configure wlan_wep; if you want to use WPA with the ath driver load/configure wlan_tkip, wlan_ccmp, and wlan_xauth as required. 20041201: The wlan support has been updated to split the crypto support into separate modules. For static WEP you must configure the wlan_wep module in your system or build and install the module in place where it can be loaded (the kernel will auto-load the module when a wep key is configured). 20041201: The ath driver has been updated to split the tx rate control algorithm into a separate module. You need to include either ath_rate_onoe or ath_rate_amrr when configuring the kernel.
The very term “reverse” gives it away: it's the wrong way round. Complete reversal is unintelligible, so every reverse chronological document must decide the granularity of the reversal. For example, consider the following entries in the FreeBSD UPDATING file, which contains a log of changes to the source base:
A large number of documents on the web are written in “reverse chronological” order. Typical things are “blogs”, resumes and other logs. I hate the idea!
Greg's home page | Greg's diary | Greg's photos | Copyright |