Re: [PATCH] docs: pt_BR: translate process/1.Intro.rst

[Jonathan Corbet <corbet@lwn.net>]

Daniel C.: please CC the documentation maintainer on docs patches.

Daniel P.: thanks for reviewing!  I do have some comments below...

Daniel Pereira <danielmaraboo@gmail.com> writes:

> On Mon, Mar 16, 2026 at 6:25 PM Daniel Castro <arantescastro@gmail.com> wrote:
>>
>> Add Brazilian Portuguese translation of the development process
>> introduction (Documentation/process/1.Intro.rst), covering the
>> executive summary, importance of mainline code, and licensing.
>>
>> Assisted-by: Claude:claude-opus-4-6
>> Signed-off-by: Daniel Castro <arantescastro@gmail.com>
>> ---
>>  Documentation/translations/pt_BR/index.rst    |   1 +
>>  .../translations/pt_BR/process/1.Intro.rst    | 300 ++++++++++++++++++
>>  2 files changed, 301 insertions(+)
>>  create mode 100644 Documentation/translations/pt_BR/process/1.Intro.rst

> Removal of AI credits: Remove the Assisted-by: Claude tag. Kernel
> documentation requires full human review to ensure no conceptual or
> literal translation errors. As the author, you are legally responsible
> for the integrity of the text under the DCO.

I have to disagree with this; the Assisted-by tag is part of our
emerging consensus on work resulting from these tools.  See
Documentation/process/coding-assistants.rst.

I will confess to having mixed feelings, at best, about the use of such
tools.  But I do not feel it's right to ban such output just based on
its origin.  Documentation patches, like all others, need to be
carefully reviewed and are, in the end, the responsibility of the person
submitting them.

> There are lines with residual white spaces (visible as isolated +
> symbols in the diff). Remove these to prevent rendering warnings in
> Sphinx.

Comments like this are best made inline so that the submitter can see
exactly where the problem is.

> Legal Terminology: In the licensing section, change "propriedade
> original" to "titularidade original". This is the technically correct
> term for copyright in Portuguese.
>  Remove the reference label at the top of the file (..
> _development_process_intro:), as it is unnecessary for this stage of
> the translation.

These too - please use our normal style for review comments.

Glad to see you calling out the top label! :)

Daniel C.: the presence of that label suggests that you did not actually
build your changes with sphinx, since it should have resulted in a
"duplicate label" warning.

Thanks,

jon