1 |
On Tue, Sep 02, 2008 at 07:14:44PM -0700, Josh Saddler wrote: |
2 |
> Hi guys. I dunno about you, but I'm getting tired of folks bashing our docs |
3 |
> as being "out of date", "stale", "old", or "inaccurate" just because of the |
4 |
> displayed date of the last update. |
5 |
> |
6 |
> I propose that we keep the date inside the document code, for our own |
7 |
> internal purposes, but remove it from the final rendered page. |
8 |
|
9 |
As swift has said in previous posts, keep the last change date visible is |
10 |
a quite useful while reading documentation. |
11 |
|
12 |
> |
13 |
> As you know, the date displayed has little relevance to when we last |
14 |
> actually touched-up the document, given our internal date bump policy. |
15 |
> |
16 |
|
17 |
Or I'm missing something or the date should reflect the date of the last |
18 |
doc version. |
19 |
|
20 |
> |
21 |
> So. There's my proposal. Thoughts? |
22 |
> |
23 |
|
24 |
What about change 'Updated' to 'Last Change' being 'Last Change' a link |
25 |
which point to an entry in the FAQ explaining what is the last change |
26 |
and why it doesn't imply that the doc is out of date. |
27 |
|
28 |
Regards. |
29 |
|
30 |
-- |
31 |
Jose Luis Rivero <yoswink@g.o> |
32 |
Gentoo/Doc Gentoo/Alpha |