Commit 53827745 authored by Jonathan Corbet's avatar Jonathan Corbet

A reworked process/index.rst

The process book is arguably the most important documentation we have; the
top three trafficked pages on docs.kernel.org are found here.  Make a
beginning effort to impose a more useful organization on this page to ease
developers into the community.
Acked-by: default avatarVegard Nossum <vegard.nossum@oracle.com>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent 4b2df884
...@@ -15,49 +15,96 @@ to learn about how our community works. Reading these documents will make ...@@ -15,49 +15,96 @@ to learn about how our community works. Reading these documents will make
it much easier for you to get your changes merged with a minimum of it much easier for you to get your changes merged with a minimum of
trouble. trouble.
Below are the essential guides that every developer should read. An introduction to how kernel development works
-----------------------------------------------
Read these documents first: an understanding of the material here will ease
your entry into the kernel community.
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
license-rules
howto howto
code-of-conduct
code-of-conduct-interpretation
development-process development-process
submitting-patches submitting-patches
handling-regressions submit-checklist
Tools and technical guides for kernel developers
------------------------------------------------
This is a collection of material that kernel developers should be familiar
with.
.. toctree::
:maxdepth: 1
changes
programming-language programming-language
coding-style coding-style
maintainer-handbooks
maintainer-pgp-guide maintainer-pgp-guide
email-clients email-clients
applying-patches
backporting
adding-syscalls
volatile-considered-harmful
botching-up-ioctls
Policy guides and developer statements
--------------------------------------
These are the rules that we try to live by in the kernel community (and
beyond).
.. toctree::
:maxdepth: 1
license-rules
code-of-conduct
code-of-conduct-interpretation
contribution-maturity-model
kernel-enforcement-statement kernel-enforcement-statement
kernel-driver-statement kernel-driver-statement
stable-api-nonsense
stable-kernel-rules
management-style
researcher-guidelines
For security issues, see: Dealing with bugs
-----------------
Bugs are a fact of life; it is important that we handle them properly.
The documents below describe our policies around the handling of a couple
of special classes of bugs: regressions and security problems.
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
handling-regressions
security-bugs security-bugs
embargoed-hardware-issues embargoed-hardware-issues
Other guides to the community that are of interest to most developers are: Maintainer information
----------------------
How to find the people who will accept your patches.
.. toctree::
:maxdepth: 1
maintainer-handbooks
maintainers
Other material
--------------
Here are some other guides to the community that are of interest to most
developers:
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
changes
stable-api-nonsense
management-style
stable-kernel-rules
submit-checklist
kernel-docs kernel-docs
deprecated deprecated
maintainers
researcher-guidelines
contribution-maturity-model
These are some overall technical guides that have been put here for now for These are some overall technical guides that have been put here for now for
lack of a better place. lack of a better place.
...@@ -65,12 +112,7 @@ lack of a better place. ...@@ -65,12 +112,7 @@ lack of a better place.
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
applying-patches
backporting
adding-syscalls
magic-number magic-number
volatile-considered-harmful
botching-up-ioctls
clang-format clang-format
../arch/riscv/patch-acceptance ../arch/riscv/patch-acceptance
../core-api/unaligned-memory-access ../core-api/unaligned-memory-access
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment