lkml.org 
[lkml]   [2022]   [Jun]   [27]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[RFC PATCH 03/11] docs: kernel-docs: reflect that it is community-maintained
    Date
    Remove and rephrase statements that only make sense if a single author
    exclusively would maintain this document, but we would really want to
    consider this being a page maintained by the kernel community, as it is
    placed in the kernel repository, and let us hope that more contributors
    suggest some more documents.

    Further, do some minor word-smithing.

    Signed-off-by: Lukas Bulwahn <lukas.bulwahn@gmail.com>
    ---
    Documentation/process/kernel-docs.rst | 22 +++++++++-------------
    1 file changed, 9 insertions(+), 13 deletions(-)

    diff --git a/Documentation/process/kernel-docs.rst b/Documentation/process/kernel-docs.rst
    index 5d6fa71895cc..b2523267ffc7 100644
    --- a/Documentation/process/kernel-docs.rst
    +++ b/Documentation/process/kernel-docs.rst
    @@ -3,7 +3,8 @@
    Index of Further Kernel Documentation
    =====================================

    - Juan-Mariano de Goyeneche <jmseyas@dit.upm.es>
    +Initial Author: Juan-Mariano de Goyeneche (<jmseyas@dit.upm.es>;
    +email address is defunct now.)

    The need for a document like this one became apparent in the
    linux-kernel mailing list as the same questions, asking for pointers
    @@ -16,21 +17,16 @@ philosophy and design decisions behind this code.

    Unfortunately, not many documents are available for beginners to
    start. And, even if they exist, there was no "well-known" place which
    -kept track of them. These lines try to cover this lack. All documents
    -available on line known by the author are listed, while some reference
    -books are also mentioned.
    +kept track of them. These lines try to cover this lack.

    PLEASE, if you know any paper not listed here or write a new document,
    -send me an e-mail, and I'll include a reference to it here. Any
    -corrections, ideas or comments are also welcomed.
    +include a reference to it here, following the kernel's patch submission
    +process. Any corrections, ideas or comments are also welcome.

    -The papers that follow are listed in no particular order. All are
    -cataloged with the following fields: the document's "Title", the
    -"Author"/s, the "URL" where they can be found, some "Keywords" helpful
    -when searching for specific topics, and a brief "Description" of the
    -Document.
    -
    -Enjoy!
    +All documents are cataloged with the following fields: the document's
    +"Title", the "Author"/s, the "URL" where they can be found, some
    +"Keywords" helpful when searching for specific topics, and a brief
    +"Description" of the Document.

    .. note::

    --
    2.17.1
    \
     
     \ /
      Last update: 2022-06-27 17:21    [W:2.592 / U:0.340 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site