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

[Jonathan Corbet <corbet@lwn.net>]

On Fri, 27 Jul 2018 09:46:47 +0200
Federico Vaga <federico.vaga@vaga.pv.it> 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
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html