Re: [PATCH] docs: hu_HU: add Hungarian translation of howto.rst

[Jonathan Corbet <corbet@lwn.net>]

Martin Kavasi <martin.kavasi3@gmail.com> writes:

> Add an initial Hungarian translation of Documentation/process/howto.rst.
>
> Also add the Hungarian documentation translation infrastructure,
> including the hu_HU index and disclaimer, register the translation
> directory in Documentation/translations/index.rst, and add a
> MAINTAINERS entry for Hungarian documentation.
>
> Signed-off-by: Martin Kavasi <1ai1d7wbz@proton.me>
> ---
>  Documentation/sphinx/translations.py          |  1 +
>  .../translations/hu_HU/disclaimer-hu.rst      |  8 +++
>  Documentation/translations/hu_HU/index.rst    | 55 +++++++++++++++++
>  .../translations/hu_HU/process/howto.rst      | 61 +++++++++++++++++++
>  Documentation/translations/index.rst          |  1 +
>  MAINTAINERS                                   |  5 ++
>  6 files changed, 131 insertions(+)
>  create mode 100644 Documentation/translations/hu_HU/disclaimer-hu.rst
>  create mode 100644 Documentation/translations/hu_HU/index.rst
>  create mode 100644 Documentation/translations/hu_HU/process/howto.rst

Thanks for working to improve our documentation.  You really should copy
the maintainer (me) for patches like this, though; our process
documentation covers that.

Did you do this translation yourself, or was there LLM involvement in
this work?

Also ...

[...]

> diff --git a/Documentation/translations/hu_HU/process/howto.rst b/Documentation/translations/hu_HU/process/howto.rst
> new file mode 100644
> index 000000000000..f0d1efa37f9c
> --- /dev/null
> +++ b/Documentation/translations/hu_HU/process/howto.rst
> @@ -0,0 +1,61 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. _process_howto:

This will cause a build error.  This means you have not actually built
the documentation after making your changes.

The duplicate-label problem is typically addressed by adding the
translation language to the label name.  This top-of-file label, though,
is entirely unneeded and should simply be removed.

> +.. include:: ../disclaimer-hu.rst
> +
> +:Original: :ref:`Documentation/process/howto.rst <process_howto>`
> +:Translator: Martin Kavasi <1ai1d7wbz@proton.me>
> +
> +HOGYAN fejlesszünk Linux-kernelt
> +================================
> +
> +Ez a témával kapcsolatos legátfogóbb dokumentum. Útmutatást ad ahhoz,
> +hogyan válhat valaki Linux-kernel fejlesztővé, valamint hogyan sajátíthatja
> +el a Linux-kernel fejlesztői közösséggel való együttműködéshez szükséges
> +ismereteket. Nem próbálja a kernelprogramozás technikai részleteit
> +bemutatni, hanem abban segít, hogy megtaláld a megfelelő kiindulópontot.
> +
> +Ha a dokumentumban található információk elavulnak, kérjük, küldj javítást
> +a fájl karbantartójának, akinek a neve a dokumentum alján található.
> +
> +
> +Bevezetés
> +---------
> +
> +Tehát szeretnéd megtanulni, hogyan válhatsz Linux-kernel fejlesztővé?
> +Vagy a vezetőd azt mondta: „Írj egy Linux-illesztőprogramot ehhez az
> +eszközhöz.” Ennek a dokumentumnak az a célja, hogy megtanítson mindarra,
> +amire ennek eléréséhez szükséged van: bemutatja a követendő folyamatot,
> +és tanácsokat ad a közösséggel való együttműködéshez. Megpróbálja azt is
> +elmagyarázni, hogy a közösség miért úgy működik, ahogyan működik.
> +A kernel többnyire C nyelven íródik, néhány architektúrafüggő része pedig assembly nyelven. A kernel fejlesztéséhez elengedhetetlen a C nyelv alapos ismerete. Az assembly nyelv ismerete — bármely architektúra esetében — nem szükséges, kivéve, ha az adott architektúrához alacsony szintű fejlesztést tervezel.

You need to observe the 80-column line limit in documentation; did
checkpatch.pl not warn you about this?

> +
> +Bár az alábbi könyvek nem helyettesítik a megfelelő C nyelvű képzést és/vagy a többéves tapasztalatot, referenciaanyagként hasznosak lehetnek:
> +
> +    "The C Programming Language" — Kernighan és Ritchie [Prentice Hall]
> +    "Practical C Programming" — Steve Oualline [O'Reilly]
> +    "C: A Reference Manual" — Harbison és Steele [Prentice Hall]
> +
> +A kernel a GNU C-t és a GNU eszközláncot használja. Bár megfelel az ISO C11 szabványnak, számos olyan kiterjesztést használ, amelyek nem részei a szabványnak. A kernel önálló C-környezetként működik, és nem támaszkodik a szabványos C-könyvtárra, ezért a C szabvány bizonyos részei nem támogatottak.
> +
> +Tetszőleges long long típusú osztás és lebegőpontos műveletek nem engedélyezettek. Időnként nehéz lehet megérteni, milyen feltételezéseket tesz a kernel az eszközlánccal kapcsolatban, illetve milyen kiterjesztéseket használ. Sajnos ezekhez nincs egyetlen, mindenre kiterjedő referencia. További információért kérjük, tekintsd meg a GCC információs oldalait (info gcc).
> +
> +Ne feledd, hogy azt próbálod megtanulni, hogyan működj együtt a már
> +létező fejlesztői közösséggel. Ez egy sokszínű közösség, amely magas
> +elvárásokat támaszt a kódolással, a stílussal és a munkafolyamatokkal
> +szemben. Ezek a szabályok és elvárások idővel alakultak ki, annak
> +tapasztalatai alapján, hogy mi működik a legjobban egy ilyen nagy és
> +földrajzilag szétszórt csapat esetében.
> +
> +Próbálj meg előre minél többet megtanulni ezekről az elvárásokról, mivel
> +jól dokumentáltak; ne várd el, hogy mások alkalmazkodjanak hozzád vagy a
> +céged munkamódszereihez.
> +
> +Jogi kérdések
> +
> +A Linux kernel forráskódja a GPL licenc alatt kerül kiadásra. Kérjük, tekintsd meg a forrásfa főkönyvtárában található COPYING fájlt. A Linux kernel licencelési szabályait, valamint az SPDX <https://spdx.org/>_ azonosítók forráskódban történő használatát a :ref:`Documentation/process/license-rules.rst <kernel_licensing>` dokumentum ismerteti. Ha további kérdéseid vannak a licenccel kapcsolatban, fordulj ügyvédhez, és ne tedd fel ezeket a Linux kernel levelezőlistáján. A levelezőlisták résztvevői nem ügyvédek, ezért jogi kérdésekben ne hagyatkozz a kijelentéseikre.
> +
> +A GPL-lel kapcsolatos gyakori kérdésekre és válaszokra vonatkozóan lásd:
> +
> +https://www.gnu.org/licenses/gpl-faq.html
> diff --git a/Documentation/translations/index.rst b/Documentation/translations/index.rst
> index b6d24f6f17d1..5f85388a83d9 100644
> --- a/Documentation/translations/index.rst
> +++ b/Documentation/translations/index.rst
> @@ -14,6 +14,7 @@ Translations
>     ko_KR/index
>     pt_BR/index
>     sp_SP/index
> +   hu_HU/index

These entries should be kept in alphabetical order

Thanks,

jon