On Sat, Jun 12, 2021 at 12:26:06PM -0500, Grzegorz Zdanowski wrote: > Hi! > > While dipping my toes in Linux kernel programming I discovered that a > lot of functions, even exported ones, lack any comment blocks or > references to documentation. Most of the time I have to resort to the > original commit message + LKML threads associated with a given > function. > > Is this intentional, or is it simply a by-product of the lack of > developer's time? If it's the latter, are documentation-only patches > welcomed? Absolutely welcome. I would suggest that you focus on a particular subsystem so that you get really deeply knowledgable about it and the bits of the kernel it interacts with. Also that you work with/through the maintainer and mailing list for that part of the kernel rather than with linux-doc. You can always cc linux-doc, of course, for getting review from people who have expertise in documentation writing, but domain-specific expertise is also needed.
