diff options
Diffstat (limited to 'Documentation/index.rst')
| -rw-r--r-- | Documentation/index.rst | 140 |
1 files changed, 76 insertions, 64 deletions
diff --git a/Documentation/index.rst b/Documentation/index.rst index cb7f1ba5b3b1..c0cf79a87c3a 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -1,8 +1,8 @@ -.. The Linux Kernel documentation master file, created by - sphinx-quickstart on Fri Feb 12 13:51:46 2016. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. +.. SPDX-License-Identifier: GPL-2.0 +.. _linux_doc: + +============================== The Linux Kernel documentation ============================== @@ -13,103 +13,115 @@ documents into a coherent whole. Please note that improvements to the documentation are welcome; join the linux-doc list at vger.kernel.org if you want to help out. -User-oriented documentation ---------------------------- +Working with the development community +====================================== -The following manuals are written for *users* of the kernel — those who are -trying to get it to work optimally on a given system. +The essential guides for interacting with the kernel's development +community and getting your work upstream. .. toctree:: - :maxdepth: 2 + :maxdepth: 1 - admin-guide/index + Development process <process/development-process> + Submitting patches <process/submitting-patches> + Code of conduct <process/code-of-conduct> + Maintainer handbook <maintainer/index> + All development-process docs <process/index> -Application-developer documentation ------------------------------------ -The user-space API manual gathers together documents describing aspects of -the kernel interface as seen by application developers. +Internal API manuals +==================== -.. toctree:: - :maxdepth: 2 +Manuals for use by developers working to interface with the rest of the +kernel. - userspace-api/index +.. toctree:: + :maxdepth: 1 + Core API <core-api/index> + Driver APIs <driver-api/index> + Subsystems <subsystem-apis> + Locking <locking/index> -Introduction to kernel development ----------------------------------- +Development tools and processes +=============================== -These manuals contain overall information about how to develop the kernel. -The kernel community is quite large, with thousands of developers -contributing over the course of a year. As with any large community, -knowing how things are done will make the process of getting your changes -merged much easier. +Various other manuals with useful information for all kernel developers. .. toctree:: - :maxdepth: 2 + :maxdepth: 1 - process/index - dev-tools/index - doc-guide/index - kernel-hacking/index + Licensing rules <process/license-rules> + Writing documentation <doc-guide/index> + Development tools <dev-tools/index> + Testing guide <dev-tools/testing-overview> + Hacking guide <kernel-hacking/index> + Tracing <trace/index> + Fault injection <fault-injection/index> + Livepatching <livepatch/index> + Rust <rust/index> -Kernel API documentation ------------------------- -These books get into the details of how specific kernel subsystems work -from the point of view of a kernel developer. Much of the information here -is taken directly from the kernel source, with supplemental material added -as needed (or at least as we managed to add it — probably *not* all that is -needed). +User-oriented documentation +=========================== + +The following manuals are written for *users* of the kernel — those who are +trying to get it to work optimally on a given system and application +developers seeking information on the kernel's user-space APIs. .. toctree:: - :maxdepth: 2 + :maxdepth: 1 - driver-api/index - core-api/index - media/index - networking/index - input/index - gpu/index - security/index - sound/index - crypto/index - filesystems/index + Administration <admin-guide/index> + Build system <kbuild/index> + Reporting issues <admin-guide/reporting-issues.rst> + Userspace tools <tools/index> + Userspace API <userspace-api/index> -Architecture-specific documentation ------------------------------------ +See also: the `Linux man pages <https://www.kernel.org/doc/man-pages/>`_, +which are kept separately from the kernel's own documentation. -These books provide programming details about architecture-specific -implementation. +Firmware-related documentation +============================== +The following holds information on the kernel's expectations regarding the +platform firmware. .. toctree:: - :maxdepth: 2 + :maxdepth: 1 - sh/index + Firmware <firmware-guide/index> + Firmware and Devicetree <devicetree/index> -Korean translations -------------------- + +Architecture-specific documentation +=================================== .. toctree:: - :maxdepth: 1 + :maxdepth: 2 + + CPU architectures <arch/index> + - translations/ko_KR/index +Other documentation +=================== -Chinese translations --------------------- +There are several unsorted documents that don't seem to fit on other parts +of the documentation body, or may require some adjustments and/or conversion +to reStructuredText format, or are simply too old. .. toctree:: :maxdepth: 1 - translations/zh_CN/index + Unsorted documentation <staging/index> -Japanese translations ---------------------- + +Translations +============ .. toctree:: - :maxdepth: 1 + :maxdepth: 2 - translations/ja_JP/index + Translations <translations/index> Indices and tables ================== |