Circling back from PR#411, and also from this Fedora Discussion thread, I'm looking for some suggestions on how to improve the "Building a Kernel from the Fedora dist-git" section, I'll gladly write them and open a PR once I get some guidance.

First issue, step 3 "Make whatever changes or customizations you need." isn't really helpful. I see 3 diverging paths here, each should probably be documented.

First, if you just want to toggle an already existing kernel build option, you would modify the kernel-local in the dist-git checkout.

Second, if you want to apply an existing patch to the kernel source, you need to add the patch in the specfile from the dist-git checkout, with a line something like Patch2: mypatch.patch, this should get picked up and applied to the source when you do the build with fedpkg local.

Third, if you want to apply a modification to the source without an existing patch, you additionally need the kernel source, not just the dist-git source. I'm assuming the flow here would be fedpkg sources to get the source, make your changes, git diff > mypatch.patch to generate the patch, and then apply the same way as above?

Second issue, the make release guidance under "Building a non-debugging kernel" doesn't make sense since you won't have a kernel source tree under the "normal" dist-git build flow. My reading of the specfile doesn't imply to me there's any equivalent option required to pass to the distgit local invocation, either via --with or --without, but if someone knew of one, I would love to document it here. Otherwise the section should just be deleted to limit confusion.