On Wed, 22 Jan 2020 15:53:02 -0800 Matthew Wilcox <willy@xxxxxxxxxxxxx> wrote: > One thing which I feel should be mentioned > is the hard work put in by hundreds of kernel maintainers who have > written kernel-doc and nobody has done the trivial work to actually > include those source files in an rst file, so all that documentation > is being ignored. A great task that's a step up from "fixing typos" is > "find documentation that's not currently in a kernel book and add it". > Even if it's just dumped into a "misc" section, having (eg) kvmalloc() > documentation in a kernel book is a benefit. Yeah, I'd thought about putting that in, then kind of forgot about it. I'll add a paragraph. > Do you want to preemptively mention the Oxford comma here? It's true, there is only One True Way Of Comma Placement, so we want to be sure people get it right...:) Thanks, jon
