From mboxrd@z Thu Jan 1 00:00:00 1970 From: corbet at lwn.net (Jonathan Corbet) Date: Wed, 15 May 2019 07:45:46 -0600 Subject: [PATCH v3 15/18] Documentation: kunit: add documentation for KUnit In-Reply-To: <20190514231902.GA12893@google.com> References: <20190514054251.186196-1-brendanhiggins@google.com> <20190514054251.186196-16-brendanhiggins@google.com> <20190514073422.4287267c@lwn.net> <20190514180810.GA109557@google.com> <20190514121623.0314bf07@lwn.net> <20190514231902.GA12893@google.com> Message-ID: <20190515074546.07700142@lwn.net> On Tue, 14 May 2019 16:19:02 -0700 Brendan Higgins wrote: > Hmmm...probably premature to bring this up, but Documentation/dev-tools/ > is kind of thrown together. Wait a minute, man... *I* created that directory, are you impugning my work? :) But yes, "kind of thrown together" is a good description of much of Documentation/. A number of people have been working for years to make that better, with some success, but there is a long way to go yet. The dev-tools directory is an improvement over having that stuff scattered all over the place — at least it's actually thrown together — but it's not the end point. > It would be nice to provide a coherent overview, maybe provide some > basic grouping as well. > > It would be nice if there was kind of a gentle introduction to the > tools, which ones you should be looking at, when, why, etc. Total agreement. All we need is somebody to write it! :) Thanks, jon From mboxrd@z Thu Jan 1 00:00:00 1970 From: corbet@lwn.net (Jonathan Corbet) Date: Wed, 15 May 2019 07:45:46 -0600 Subject: [PATCH v3 15/18] Documentation: kunit: add documentation for KUnit In-Reply-To: <20190514231902.GA12893@google.com> References: <20190514054251.186196-1-brendanhiggins@google.com> <20190514054251.186196-16-brendanhiggins@google.com> <20190514073422.4287267c@lwn.net> <20190514180810.GA109557@google.com> <20190514121623.0314bf07@lwn.net> <20190514231902.GA12893@google.com> Message-ID: <20190515074546.07700142@lwn.net> Content-Type: text/plain; charset="UTF-8" Message-ID: <20190515134546.VAQv0Q4WVoYFbktM52w2nizn1K7J1tX18k4mJs0R79Q@z> On Tue, 14 May 2019 16:19:02 -0700 Brendan Higgins wrote: > Hmmm...probably premature to bring this up, but Documentation/dev-tools/ > is kind of thrown together. Wait a minute, man... *I* created that directory, are you impugning my work? :) But yes, "kind of thrown together" is a good description of much of Documentation/. A number of people have been working for years to make that better, with some success, but there is a long way to go yet. The dev-tools directory is an improvement over having that stuff scattered all over the place — at least it's actually thrown together — but it's not the end point. > It would be nice to provide a coherent overview, maybe provide some > basic grouping as well. > > It would be nice if there was kind of a gentle introduction to the > tools, which ones you should be looking at, when, why, etc. Total agreement. All we need is somebody to write it! :) Thanks, jon