From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org [172.17.192.35]) by mail.linuxfoundation.org (Postfix) with ESMTPS id 7C45ABB6 for ; Mon, 13 Jul 2015 19:21:28 +0000 (UTC) Received: from mout.gmx.net (mout.gmx.net [212.227.17.20]) by smtp1.linuxfoundation.org (Postfix) with ESMTPS id E82CA12D for ; Mon, 13 Jul 2015 19:21:27 +0000 (UTC) From: Peter =?iso-8859-1?q?H=FCwe?= To: ksummit-discuss@lists.linuxfoundation.org Date: Mon, 13 Jul 2015 21:22:53 +0200 References: <201507130038.01474.PeterHuewe@gmx.de> <1436806006.20909.59.camel@infradead.org> <20150713133519.22018176@gandalf.local.home> In-Reply-To: <20150713133519.22018176@gandalf.local.home> MIME-Version: 1.0 Content-Type: Text/Plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <201507132122.53835.PeterHuewe@gmx.de> Cc: Dan Carpenter Subject: Re: [Ksummit-discuss] [CORE-TOPIC] Documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Am Montag, 13. Juli 2015, 19:35:19 schrieb Steven Rostedt: > A lot of these functions are from years past. We should go back and try > to document them. Perhaps we may even find and fix a few bugs in doing > so. +100! > > I forgot who said it, but I remember reading a quote that stated "When > the code does not match the comments, they are probably both wrong". +1000! :) Of course that's a huge problem, even more with our fast paced development. I think we should definitely spend more time to fix stuff/documentation we stumble upon and spent hours figuring out anyway. Peter