From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 11DFFC433E0 for ; Mon, 29 Mar 2021 22:44:58 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id CF3026192E for ; Mon, 29 Mar 2021 22:44:57 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230161AbhC2WoY (ORCPT ); Mon, 29 Mar 2021 18:44:24 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39366 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231301AbhC2WoW (ORCPT ); Mon, 29 Mar 2021 18:44:22 -0400 Received: from ms.lwn.net (ms.lwn.net [IPv6:2600:3c01:e000:3a1::42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B7521C061762; Mon, 29 Mar 2021 15:44:22 -0700 (PDT) Received: from localhost (unknown [IPv6:2601:281:8300:104d::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id EA6595CC; Mon, 29 Mar 2021 22:44:21 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net EA6595CC DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1617057862; bh=EKvmVbzD//QNEEEuaeTgAwCcHafiUeTm6qRa1v6UhRU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=sYOtGao+7Dz0cFmHAFPNFvdh2Yu9lNiRnH7BZooXPXQ03s006cMRFxZ7lELQrk7Ht DAuw9DQgpfKLCJcKPcl/aflDdDk61+qlhrkWTImsKVIoekHLDsHtdYhR+5q6wrDnGD CsU2AGIQJGF9ao20InPcr+7B2SFMcmjNDCiNSbwhhJjyrvGsUjghj78rdRUa1doXSN 6nNP4nAY9zrYtndA+Se8wPQqE52twACfVAnlfv/FduafJkEsCab5htgpUXiKPLfKGc 3un9ieOFYZHYOyaEQ5SH85S7jeuevYTugykM66xQQA7/8o1ecI56g6F63qLmKWfc/O 1o/bwKaHRjHYw== From: Jonathan Corbet To: Thorsten Leemhuis , ksummit , Greg KH , Sasha Levin , Randy Dunlap Cc: linux-doc@vger.kernel.org, Linux Kernel Mailing List , Linus Torvalds Subject: Re: [1/5] reporting-issues: header and TLDR In-Reply-To: <14d9b8a3-94ce-00a6-a17b-934ffd999697@leemhuis.info> References: <6a220d2c-568e-2e41-53a4-0800e206d0a6@leemhuis.info> <14d9b8a3-94ce-00a6-a17b-934ffd999697@leemhuis.info> Date: Mon, 29 Mar 2021 16:44:21 -0600 Message-ID: <87r1jxpol6.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Thorsten Leemhuis writes: > FWIW, on another channel someone mentioned the process in the TLDR is > quite complicated when it comes to regressions in stable and longterm > kernels. I looked at the text and it seemed like a valid complaint, esp. > as those regressions are something we really care about. > > To solve this properly I sadly had to shake up the text in this section > completely and rewrite parts of it. Find the result below. I'm quite > happy with it, as it afaics is more straight forward and easier to > understand. And it matches the step-by-step guide better. And the best > thing: it's a bit shorter than the old TLDR. I think this is much improved - concise is good! :) I really just have one little comment... > I'll wait a day or two and then will send it through the regular review > together with a few small other fixes that piled up for the text, just > wanted to add it here for completeness. > > --- > The short guide (aka TL;DR) > =========================== > > Are you facing a regression with vanilla kernels from the same stable or > longterm series? One still supported? Then search the `LKML > `_ and the `Linux stable mailing list > _` archives for matching reports to > join. If you don't find any, install `the latest release from that > series `_. If it still shows the issue, report it > to the stable mailing list and the stable maintainers. If we really want this to be a short guide that gets people to the answer quickly, we might as well put the addresses to report to right here rather than making people search for them. Thanks, jon