Re: [PATCH] doc: process: clarify scope of applying-patches as legacy reference
From: Krzysztof Kozlowski
Date: Wed Nov 04 2026 - 14:20:01 EST
On 04/11/2026 14:53, AleSZLucero via B4 Relay wrote:
> From: AleSZLucero <aleszlucero@xxxxxxxxx>
>
> The applying-patches.rst document describes the manual manipulation of
> source trees using the traditional 'patch' and 'diff' utilities. While
> technically accurate for non-Git or constrained environments, it can
> create friction for new contributors seeking the primary Git-based
> workflows.
>
> Update the opening note to explicitly state that this document serves
> as a reference for legacy or constrained workflows. Provide direct
> cross-references to submitting-patches.rst and howto.rst to steer
> contributors toward the standard Git infrastructure.
>
> Signed-off-by: AleSZLucero <aleszlucero@xxxxxxxxx>
Please use known identity (see submitting patches).
> ---
> Documentation/process/applying-patches.rst | 11 +++++++++--
> 1 file changed, 9 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/process/applying-patches.rst b/Documentation/process/applying-patches.rst
> index c269f5e1a0a3..74af6d8a2249 100644
> --- a/Documentation/process/applying-patches.rst
> +++ b/Documentation/process/applying-patches.rst
> @@ -8,8 +8,15 @@ Original by:
>
> .. note::
>
> - This document is obsolete. In most cases, rather than using ``patch``
> - manually, you'll almost certainly want to look at using Git instead.
> + This document focuses on the legacy method of manually manipulating source
> + trees using the traditional ``patch`` and ``diff`` utilities.
> +
> + For the standard Git-based workflow used in current development, including
> + how to format, apply, and send patches via Git, please refer to
> + :ref:`submitting_patches` and :ref:`howto`.
Submitting patches does not provide information on applying patches,
only about sending, right?
This document does not cover sending, therefore I see no point in
providing the reference. I guess howto has something more applicable?
Best regards,
Krzysztof