Mailing List Archive: Updated date in handbook

Updated date in handbook

Dec 29, 2011, 6:27 AM

Post #1 of 6 (2822 views)

Hi guys,

Something else I noticed is that we sometimes get questions in #gentoo or
even #gentoo-doc about the "Updated" date of the Gentoo Handbook(s). Because
of how things work, the displayed date on the handbook pages is always the
one that is for the given file.

In case of the index page, this is a somewhat old(er) version as the index
page hardly changes. Yet that is the "Updated" version most people look at.

Would it be okay if I updated doc-struct.xsl so that for handbooks, the
updated version always matches the latest update?

Other possibilities are:
- On the index page, display the latest update, but on individual chapters,
keep the current used date
- Don't touch anything and stop harassing me with your suggestions

Sven Vermeulen

Re: Updated date in handbook [ In reply to ]

quantumsummers at gentoo

Dec 29, 2011, 6:35 AM

Post #2 of 6 (2772 views)

Permalink

On Thu, Dec 29, 2011 at 8:27 AM, Sven Vermeulen <swift@gentoo.org> wrote:
> Hi guys,
>
> Something else I noticed is that we sometimes get questions in #gentoo or
> even #gentoo-doc about the "Updated" date of the Gentoo Handbook(s). Because
> of how things work, the displayed date on the handbook pages is always the
> one that is for the given file.
>
> In case of the index page, this is a somewhat old(er) version as the index
> page hardly changes. Yet that is the "Updated" version most people look at.
>
> Would it be okay if I updated doc-struct.xsl so that for handbooks, the
> updated version always matches the latest update?
>
> Other possibilities are:
> - On the index page, display the latest update, but on individual chapters,
> Â keep the current used date
> - Don't touch anything and stop harassing me with your suggestions
>
>
> Â Â Â Â Sven Vermeulen
>

Another option, although I hate to add it, would be always update the
date on the index page when anything gets updated. However that is
sort of silly. I support updating doc-struct.xsl

Cheers,
Matt
--
Matthew W. Summers
Gentoo Foundation Inc.

Re: Updated date in handbook [ In reply to ]

quantumsummers at gentoo

Dec 29, 2011, 6:35 AM

Post #3 of 6 (2761 views)

Permalink

Re: Updated date in handbook [ In reply to ]

1i5t5.duncan at cox

Dec 29, 2011, 8:07 AM

Post #4 of 6 (2769 views)

Permalink

Sven Vermeulen posted on Thu, 29 Dec 2011 14:27:21 +0000 as excerpted:

> Something else I noticed is that we sometimes get questions in #gentoo
> or even #gentoo-doc about the "Updated" date of the Gentoo Handbook(s).
> Because of how things work, the displayed date on the handbook pages is
> always the one that is for the given file.
>
> In case of the index page, this is a somewhat old(er) version as the
> index page hardly changes. Yet that is the "Updated" version most people
> look at.
>
> Would it be okay if I updated doc-struct.xsl so that for handbooks, the
> updated version always matches the latest update?
>
> Other possibilities are:
> - On the index page, display the latest update, but on individual
> chapters, keep the current used date

* What about simply prepending the single word "Page" to the existing
"Updated <date>"? Because lacking that, the current dates on the index
pages really do look like they apply to the whole thing, while "Page
Updated" is both clear enough and similar enough to the same mechanism as
I've seen it on other sites, that it should go quite a way toward
eliminating the confusion.

--
Duncan - List replies preferred. No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master." Richard Stallman

Re: Re: Updated date in handbook [ In reply to ]

swift at gentoo

Dec 29, 2011, 9:15 AM

Post #5 of 6 (2763 views)

Permalink

On Thu, Dec 29, 2011 at 04:07:18PM +0000, Duncan wrote:
> * What about simply prepending the single word "Page" to the existing
> "Updated <date>"? Because lacking that, the current dates on the index
> pages really do look like they apply to the whole thing, while "Page
> Updated" is both clear enough and similar enough to the same mechanism as
> I've seen it on other sites, that it should go quite a way toward
> eliminating the confusion.

Good suggestion, I like... err +1... err Duncan++...

Re: Re: Updated date in handbook [ In reply to ]

swift at gentoo

Dec 31, 2011, 1:28 PM

Post #6 of 6 (2768 views)

Permalink

On Thu, Dec 29, 2011 at 04:07:18PM +0000, Duncan wrote:
> * What about simply prepending the single word "Page" to the existing
> "Updated <date>"? Because lacking that, the current dates on the index
> pages really do look like they apply to the whole thing, while "Page
> Updated" is both clear enough and similar enough to the same mechanism as
> I've seen it on other sites, that it should go quite a way toward
> eliminating the confusion.

I didn't hear any other complaints against this, so I went ahead with this
suggestion.

Wkr,
Sven Vermeulen