Date:   Wed, 15 Mar 2023 11:17:33 +0700
From:   Bagas Sanjaya <bagasdotme@gmail.com>
To:     Jonathan Corbet <corbet@lwn.net>,
        Thorsten Leemhuis <linux@leemhuis.info>
Cc:     Randy Dunlap <rdunlap@infradead.org>,
        Lukas Bulwahn <lukas.bulwahn@gmail.com>,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        regressions@lists.linux.dev
Subject: Re: [PATCH v3] docs: describe how to quickly build a trimmed kernel
Message-ID: <ZBFG3UqcS7IhGP6t@debian.me>
References: <1a788a8e7ba8a2063df08668f565efa832016032.1678021408.git.linux@leemhuis.info>
 <87a60frxk0.fsf@meer.lwn.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
        protocol="application/pgp-signature"; boundary="8zDsjomzav6C/tyN"
Content-Disposition: inline
In-Reply-To: <87a60frxk0.fsf@meer.lwn.net>
Precedence: bulk


--8zDsjomzav6C/tyN
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Tue, Mar 14, 2023 at 12:35:11PM -0600, Jonathan Corbet wrote:
> This caused me to wonder if we shouldn't create a new book called
> "tutorials" for this kind of stuff, with an explicit proviso that a more
> web-oriented approach is OK in that section?  Tutorial documentation
> *is* quite different from reference material, but we've really made no
> effort to treat the two differently so far.
>=20

I think so, but I guess "web-oriented" means doing a lot of searching
the Internet to accomplish kernel-related tasks, right?

For the initial tutorial contents, I'd like to see:

  * this one (for end users and tester)
  * kernel building with development environment setup and
    patch submission (for developers)
  * kernel bisection (as in v1)
  * reporting bugs (tldr: make sure to include info as detail as you can
    get and Cc: related mailing lists [scripts/get_maintainer.pl
    helps]).

Other tutorial-style docs across Documentation/ can be candidate of
moving to Documentation/tutorials/.

Thanks.

--=20
An old man doll... just what I always wanted! - Clara

--8zDsjomzav6C/tyN
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iHUEABYKAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCZBFG1wAKCRD2uYlJVVFO
oxycAQDxmtnjJWLDKQcG+mAZm5hcoXqW4pbWc8L8JQcJIfVUOwEAl11xXNiO8swY
I+guj/o/klc20PKSltN5JZ4eQbnkQwo=
=dkCF
-----END PGP SIGNATURE-----

--8zDsjomzav6C/tyN--