On 11/19/20 4:29 AM, Thorsten Leemhuis wrote: > Am 19.11.20 um 01:29 schrieb Jonathan Corbet: >> On Sun, 15 Nov 2020 11:13:52 +0100 >> Thorsten Leemhuis <linux@xxxxxxxxxxxxx> wrote: >> >>>> So I've not had a chance to try to read through the whole thing again, >>>> will try to do so in the near future. >>> Great, thx, looking forward to it. >> OK, I have made a *quick* pass through the whole thing and sent a small >> number of comments separately. > > Great, thx, much appreciated. > >> There are things that could be tweaked >> (there always will be) but I'm not sure we should worry about those yet. >> I would suggest doing this: >> >> - Collapse the whole thing down to a patch adding reporting-bugs-v2.rst >> (or some suitable name). > > Maybe just "reporting-issues.rst" or "reporting-issues-wip.rst". The text talks about issues anyway and rarely uses the word "bug". > >> I do wonder if it should also move to the >> process manual as part of this; not only admins will report bugs. > > > I had wondered about this myself a few weeks ago, but I assumed someone had good reasons to put it in the admin section. > > /me looks closer > > Hmmm, now I'm unsure myself where to place it: > > * Documentation/admin/ is introduced as "The Linux kernel user’s and administrator’s guide" (https://www.kernel.org/doc/html/latest/admin-guide/). So maybe it's the right place that just uses a directory name that's easily misunderstood :-/ > > * the process section starts with the words "So you want to be a Linux kernel developer? Welcome!" (https://www.kernel.org/doc/html/latest/process/). That might be a bit intimidating for people that just want to report a bug. > > I guess it's best if you decide. I prefer to leave it in /admin-guide/. -- ~Randy
