The Problem with Linux Kernel Documentation, and How We’re Fixing It

September 23, 2016 –
Mauro Carvalho Chehab

This article is the first in a series on changes to Linux Kernel documentation.
The Linux Kernel has one of the biggest communities in the open source world; the numbers are impressive: over 4,000 contributors per year, resulting in about 8 changes per hour. That results in 4,600 lines of code added every day and a major release every 9-10 weeks. With these impressive numbers, it’s impossible for a traditional printed book to follow the changes because by the time the book is finally written, reviewed and published, a lot of changes have already merged upstream. So, the best way to maintain updated documentation is to keep it close to the source code. This way, when some changes happen, the developer that wrote such changes can also update the corresponding documents. That works great in theory, but it is not as effective as


Original URL: http://feedproxy.google.com/~r/feedsapi/BwPx/~3/23sw2CEIsbE/

Original article

Comments are closed.

Proudly powered by WordPress | Theme: Baskerville 2 by Anders Noren.

Up ↑

%d bloggers like this: