| 1 |
Sven Vermeulen posted on Thu, 29 Dec 2011 14:27:21 +0000 as excerpted: |
| 2 |
|
| 3 |
> Something else I noticed is that we sometimes get questions in #gentoo |
| 4 |
> or even #gentoo-doc about the "Updated" date of the Gentoo Handbook(s). |
| 5 |
> Because of how things work, the displayed date on the handbook pages is |
| 6 |
> always the one that is for the given file. |
| 7 |
> |
| 8 |
> In case of the index page, this is a somewhat old(er) version as the |
| 9 |
> index page hardly changes. Yet that is the "Updated" version most people |
| 10 |
> look at. |
| 11 |
> |
| 12 |
> Would it be okay if I updated doc-struct.xsl so that for handbooks, the |
| 13 |
> updated version always matches the latest update? |
| 14 |
> |
| 15 |
> Other possibilities are: |
| 16 |
> - On the index page, display the latest update, but on individual |
| 17 |
> chapters, keep the current used date |
| 18 |
|
| 19 |
* What about simply prepending the single word "Page" to the existing |
| 20 |
"Updated <date>"? Because lacking that, the current dates on the index |
| 21 |
pages really do look like they apply to the whole thing, while "Page |
| 22 |
Updated" is both clear enough and similar enough to the same mechanism as |
| 23 |
I've seen it on other sites, that it should go quite a way toward |
| 24 |
eliminating the confusion. |
| 25 |
|
| 26 |
-- |
| 27 |
Duncan - List replies preferred. No HTML msgs. |
| 28 |
"Every nonfree program has a lord, a master -- |
| 29 |
and if you use the program, he is your master." Richard Stallman |
Archives