Re: [PATCH 2/2] doc:it_IT: translation for kernel-hacking

From: Jonathan Corbet
Date: Fri Jul 27 2018 - 17:34:28 EST


On Fri, 27 Jul 2018 09:46:47 +0200
Federico Vaga <federico.vaga@xxxxxxxxxx> wrote:

> Generally speaking, how readers can understand
> how old is a document or if it still correct (in the sense that the document
> and the correspondent code are in sync)?

We don't have a good answer to that, really. Some of our docs are
up-to-the-second current, and others still talk about how to find out
which vacuum tube has gone bad in your system. It's a trap for our
readers, unfortunately. My plan has been to try to bring some more order
to Documentation/ first, hopefully cleaning things up a bit on the way.


> How this is handled? Just by enforcing people to update
> the documentation when they change, for example, an interface that has been
> documented?

magari ... talk of such enforcement is a recurring thing, but nobody has
the will to actually do that.

jon