diff --git a/README b/README index fd903645e6de..3a1f61948ceb 100644 --- a/README +++ b/README @@ -2,17 +2,17 @@ Linux kernel ============ There are several guides for kernel developers and users. These guides can -be rendered in a number of formats, like HTML and PDF. Please read +be rendered in several formats, such as HTML and PDF. Please read Documentation/admin-guide/README.rst first. -In order to build the documentation, use ``make htmldocs`` or +To build the documentation, use ``make htmldocs`` or ``make pdfdocs``. The formatted documentation can also be read online at: https://www.kernel.org/doc/html/latest/ There are various text files in the Documentation/ subdirectory, -several of them using the reStructuredText markup notation. +Several of them use the reStructuredText markup notation. Please read the Documentation/process/changes.rst file, as it contains the requirements for building and running the kernel, and information about -the problems which may result by upgrading your kernel. +the problems which may result from upgrading your kernel.