Mauro Carvalho Chehab | f7c9fe4 | 2016-09-19 08:07:36 -0300 | [diff] [blame] | 1 | .. _development_conclusion: |
| 2 | |
| 3 | For more information |
| 4 | ==================== |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 5 | |
| 6 | There are numerous sources of information on Linux kernel development and |
| 7 | related topics. First among those will always be the Documentation |
Federico Vaga | f77af63 | 2018-11-21 01:35:19 +0100 | [diff] [blame] | 8 | directory found in the kernel source distribution. The top-level :ref:`process/howto.rst <process_howto>` |
| 9 | file is an important starting point; :ref:`process/submitting-patches.rst <submittingpatches>` |
| 10 | and :ref:`process/submitting-drivers.rst <submittingdrivers>` |
| 11 | are also something which all kernel developers should |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 12 | read. Many internal kernel APIs are documented using the kerneldoc |
| 13 | mechanism; "make htmldocs" or "make pdfdocs" can be used to generate those |
| 14 | documents in HTML or PDF format (though the version of TeX shipped by some |
| 15 | distributions runs into internal limits and fails to process the documents |
| 16 | properly). |
| 17 | |
| 18 | Various web sites discuss kernel development at all levels of detail. Your |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 19 | author would like to humbly suggest https://lwn.net/ as a source; |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 20 | information on many specific kernel topics can be found via the LWN kernel |
| 21 | index at: |
| 22 | |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 23 | https://lwn.net/Kernel/Index/ |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 24 | |
| 25 | Beyond that, a valuable resource for kernel developers is: |
| 26 | |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 27 | https://kernelnewbies.org/ |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 28 | |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 29 | And, of course, one should not forget https://kernel.org/, the definitive |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 30 | location for kernel release information. |
| 31 | |
| 32 | There are a number of books on kernel development: |
| 33 | |
| 34 | Linux Device Drivers, 3rd Edition (Jonathan Corbet, Alessandro |
| 35 | Rubini, and Greg Kroah-Hartman). Online at |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 36 | https://lwn.net/Kernel/LDD3/. |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 37 | |
| 38 | Linux Kernel Development (Robert Love). |
| 39 | |
| 40 | Understanding the Linux Kernel (Daniel Bovet and Marco Cesati). |
| 41 | |
| 42 | All of these books suffer from a common fault, though: they tend to be |
| 43 | somewhat obsolete by the time they hit the shelves, and they have been on |
| 44 | the shelves for a while now. Still, there is quite a bit of good |
| 45 | information to be found there. |
| 46 | |
| 47 | Documentation for git can be found at: |
| 48 | |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 49 | https://www.kernel.org/pub/software/scm/git/docs/ |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 50 | |
Alexander A. Klimov | 93431e0 | 2020-05-26 08:05:44 +0200 | [diff] [blame] | 51 | https://www.kernel.org/pub/software/scm/git/docs/user-manual.html |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 52 | |
| 53 | |
Mauro Carvalho Chehab | f7c9fe4 | 2016-09-19 08:07:36 -0300 | [diff] [blame] | 54 | Conclusion |
| 55 | ========== |
Jonathan Corbet | 75b0214 | 2008-09-30 15:15:56 -0600 | [diff] [blame] | 56 | |
| 57 | Congratulations to anybody who has made it through this long-winded |
| 58 | document. Hopefully it has provided a helpful understanding of how the |
| 59 | Linux kernel is developed and how you can participate in that process. |
| 60 | |
| 61 | In the end, it's the participation that matters. Any open source software |
| 62 | project is no more than the sum of what its contributors put into it. The |
| 63 | Linux kernel has progressed as quickly and as well as it has because it has |
| 64 | been helped by an impressively large group of developers, all of whom are |
| 65 | working to make it better. The kernel is a premier example of what can be |
| 66 | done when thousands of people work together toward a common goal. |
| 67 | |
| 68 | The kernel can always benefit from a larger developer base, though. There |
| 69 | is always more work to do. But, just as importantly, most other |
| 70 | participants in the Linux ecosystem can benefit through contributing to the |
| 71 | kernel. Getting code into the mainline is the key to higher code quality, |
| 72 | lower maintenance and distribution costs, a higher level of influence over |
| 73 | the direction of kernel development, and more. It is a situation where |
| 74 | everybody involved wins. Fire up your editor and come join us; you will be |
| 75 | more than welcome. |