This is an automated email from the git hooks/post-receive script.
guix_mirror_bot pushed a commit to branch master
in repository guix.
The following commit(s) were added to refs/heads/master by this push:
new 39b5e8e762f doc: Ask translators to contribute via pull request.
39b5e8e762f is described below
commit 39b5e8e762f88349487aafe047a65614939e4555
Author: Florian Pelz <[email protected]>
AuthorDate: Thu Oct 29 15:43:53 2026 +0100
doc: Ask translators to contribute via pull request.
* doc/contributing.texi (Translating Guix): Document the current dilemma.
(Source Tree Structure): Do not refer to Weblate.
(Synopses and Descriptions): Likewise.
(Writing Documentation): Likewise.
Merges: guix/guix!12189
Relates-to: guix/translations#10
---
doc/contributing.texi | 42 ++++++++++++++++--------------------------
1 file changed, 16 insertions(+), 26 deletions(-)
diff --git a/doc/contributing.texi b/doc/contributing.texi
index d1921c73813..e6819cd1ed1 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1050,8 +1050,9 @@ for information on Texinfo markup language.
@item po
This is the location of translations of Guix itself, of package synopses
and descriptions, of the manual, and of the cookbook. Note that
-@file{.po} files that live here are pulled directly from Weblate
-(@pxref{Translating Guix}).
+@file{.po} files that live here are pulled directly from the
+@url{https://codeberg.org/guix/translations/, guix/translations
+repository} (@pxref{Translating Guix}).
@item etc
Miscellaneous files: shell completions, support for systemd and other
@@ -1425,8 +1426,7 @@ such as @command{guix show} take care of rendering it
appropriately.
Synopses and descriptions are translated by volunteers
-@uref{https://translate.codeberg.org/projects/guix/packages, at
-Weblate} so that as many users as possible can read them in
+so that as many users as possible can read them in
their native language. User interfaces search them and display them in
the language specified by the current locale.
@@ -3299,8 +3299,9 @@ section), or @file{doc/guix-cookbook.texi} for the
cookbook. If
you compiled the Guix repository before, you will have
many more @file{.texi} files that are translations of these
documents. Do not modify them, the translation is managed through
-@uref{https://translate.codeberg.org/projects/guix, Weblate}.
-@xref{Translating Guix} for more information.
+@url{https://codeberg.org/guix/translations/, a separate
+guix/translations repository}. @xref{Translating Guix} for more
+information.
To render documentation, you must first make sure that you ran
@command{./configure} in your source tree (@pxref{Running Guix Before
@@ -3332,9 +3333,12 @@ get involved, what can be translated, what mistakes you
should avoid and
what we can do to help you!
Guix is a big project that has multiple components that can be translated.
-We coordinate the translation effort on a
+We used to coordinate the translation effort on a
@uref{https://translate.codeberg.org/projects/guix/,Weblate instance}
-hosted by Codeberg. You will need an account to submit translations.
+hosted by Codeberg. However, like on a barely moderated wiki, we
+struggled with many erroneous contributions and machine translations.
+Currently, translations of Guix itself can only be contributed as pull
+requests.
Some of the software packaged in Guix also contain translations. We do not
host a translation platform for them. If you want to translate a package
@@ -3348,7 +3352,8 @@ Many GNU and non-GNU packages can be translated on the
with multiple components have their own platform. For instance, GNOME has
its own platform, @uref{https://l10n.gnome.org/,Damned Lies}.
-Guix has five components hosted on Weblate.
+Guix has five components hosted on
+@url{https://codeberg.org/guix/translations/}.
@itemize
@item @code{guix} contains all the strings from the Guix software (the
@@ -3363,34 +3368,19 @@ Guix has five components hosted on Weblate.
@subsubheading General Directions
-Once you get an account, you should be able to select a component from
-@uref{https://translate.codeberg.org/projects/guix/,the guix project},
-and select a language. If your language does not appear in the list, go
-to the bottom and click on the ``Start new translation'' button. Select
-the language you want to translate to from the list, to start your new
-translation.
-
Like lots of other free software packages, Guix uses
@uref{https://www.gnu.org/software/gettext,GNU Gettext} for its translations,
with which translatable strings are extracted from the source code to so-called
PO files.
Even though PO files are text files, changes should not be made with a text
-editor but with PO editing software. Weblate integrates PO editing
-functionality. Alternatively, translators can use any of various
+editor but with PO editing software. Translators can use any of various
free-software tools for filling in translations, of which
-@uref{https://poedit.net/,Poedit} is one example, and (after logging in)
-@uref{https://docs.weblate.org/en/latest/user/files.html,upload} the changed
-file. There is also a special
+@uref{https://poedit.net/,Poedit} is one example. There is also a special
@uref{https://www.emacswiki.org/emacs/PoMode,PO editing mode} for users of GNU
Emacs. Over time translators find out what software they are happy with and
what features they need.
-On Weblate, you will find various links to the editor, that will show various
-subsets (or all) of the strings. Have a look around and at the
-@uref{https://docs.weblate.org/en/latest/,documentation} to familiarize
-yourself with the platform.
-
@subsubheading Translation Components
In this section, we provide more detailed guidance on the translation