Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
From:   Federico Vaga <federico.vaga@vaga.pv.it>
To:     Jonathan Corbet <corbet@lwn.net>
Cc:     linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        Alessia Mantegazza <amantegazza@vaga.pv.it>
Subject: Re: [PATCH 2/2] doc:it_IT: translation for kernel-hacking
Date:   Fri, 27 Jul 2018 09:46:47 +0200
Message-ID: <1944849.qmSSJrysef@pcbe13614>
In-Reply-To: <20180726162330.786826cf@lwn.net>
References: <20180706220517.28623-1-federico.vaga@vaga.pv.it> <20180706220517.28623-3-federico.vaga@vaga.pv.it> <20180726162330.786826cf@lwn.net>
MIME-Version: 1.0
Content-Transfer-Encoding: 7Bit
Content-Type: text/plain; charset="us-ascii"
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

I know, but I believe they are still good documents if read with a bit of 
pragmatism: many concepts there are evergreen. Then, it clearly says 
"unreliable" ;P

Your wonder, make me wonder. 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)? Clearly here it says that it has been 
written for Linux 2.6, but most documents do not say anything about the last 
significant review/update. This let people think that documentation and code 
are always in sync. How this is handled? Just by enforcing people to update 
the documentation when they change, for example, an interface that has been 
documented?

On Friday, July 27, 2018 12:23:30 AM CEST Jonathan Corbet wrote:
> On Sat,  7 Jul 2018 00:05:17 +0200
> 
> Federico Vaga <federico.vaga@vaga.pv.it> wrote:
> > This patch includes the kernel-hacking translation in Italian (both
> > hacking.rst and locking.rst).
> > 
> > It adds also the anchors for the english kernel-hacking documents.
> 
> Applied, thanks.  Though I do have to wonder a bit, since these documents
> are ancient and haven't seen a lot of maintenance in recent times...
> 
> jon


-- 
Federico Vaga
http://www.federicovaga.it/