Re: Documentation of kernel messages (Summary)

[Theodore Tso]

On Fri, Jul 13, 2007 at 08:49:00PM +0800, Li Yang wrote:
> On Fri, 2007-07-13 at 11:53 +0100, Alan Cox wrote:
> > > One thing that would be a VERY good idea is to make sure that each
> > > translated document is tagged with when it was last translated, and
> > > against which kernel version (using either a GIT commit id or a
> > 
> > The English versions need a last updated too, that way we would know when
> > they are past their best before date (as most of them are)
> 
> Good idea.  So a "last updated" date field will be required for both the
> English and translated documents.  Date will be more straight forward
> than using commit id, IMHO.

Well, date and kernel version id, then.  Otherwise they may be
confusion if the translator is using 2.6.16.35 as opposed to
2.6.22-git3, etc.  I would hope that the translator would always be
using only the latest development branch, but I wouldn't want to
always bet on that.  One advantage of using git commit id is that
there's no question about what the source document version was for the
translation.  It also makes it easier for the translator since they
can just diff between the last git commit id, and HEAD, and then
update their translation accordingly.

							- Ted
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/