1.. SPDX-License-Identifier: GPL-2.0 2 3.. _linux_doc: 4 5The Linux Kernel documentation 6============================== 7 8This is the top level of the kernel's documentation tree. Kernel 9documentation, like the kernel itself, is very much a work in progress; 10that is especially true as we work to integrate our many scattered 11documents into a coherent whole. Please note that improvements to the 12documentation are welcome; join the linux-doc list at vger.kernel.org if 13you want to help out. 14 15Working with the development community 16-------------------------------------- 17 18The essential guides for interacting with the kernel's development 19community and getting your work upstream. 20 21.. toctree:: 22 :maxdepth: 1 23 24 process/development-process 25 process/submitting-patches 26 Code of conduct <process/code-of-conduct> 27 maintainer/index 28 All development-process docs <process/index> 29 30 31Internal API manuals 32-------------------- 33 34Manuals for use by developers working to interface with the rest of the 35kernel. 36 37.. toctree:: 38 :maxdepth: 1 39 40 core-api/index 41 driver-api/index 42 subsystem-apis 43 Locking in the kernel <locking/index> 44 45Development tools and processes 46------------------------------- 47 48Various other manuals with useful information for all kernel developers. 49 50.. toctree:: 51 :maxdepth: 1 52 53 process/license-rules 54 doc-guide/index 55 dev-tools/index 56 dev-tools/testing-overview 57 kernel-hacking/index 58 trace/index 59 fault-injection/index 60 livepatch/index 61 62 63User-oriented documentation 64--------------------------- 65 66The following manuals are written for *users* of the kernel — those who are 67trying to get it to work optimally on a given system and application 68developers seeking information on the kernel's user-space APIs. 69 70.. toctree:: 71 :maxdepth: 1 72 73 admin-guide/index 74 The kernel build system <kbuild/index> 75 admin-guide/reporting-issues.rst 76 User-space tools <tools/index> 77 userspace-api/index 78 79 80Firmware-related documentation 81------------------------------ 82The following holds information on the kernel's expectations regarding the 83platform firmwares. 84 85.. toctree:: 86 :maxdepth: 1 87 88 firmware-guide/index 89 devicetree/index 90 91 92Architecture-specific documentation 93----------------------------------- 94 95.. toctree:: 96 :maxdepth: 2 97 98 arch 99 100 101Other documentation 102------------------- 103 104There are several unsorted documents that don't seem to fit on other parts 105of the documentation body, or may require some adjustments and/or conversion 106to ReStructured Text format, or are simply too old. 107 108.. toctree:: 109 :maxdepth: 1 110 111 staging/index 112 113 114Translations 115------------ 116 117.. toctree:: 118 :maxdepth: 2 119 120 translations/index 121 122Indices and tables 123================== 124 125* :ref:`genindex` 126