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 7d327ba2d55 doc: Reinstate Weblate.
7d327ba2d55 is described below

commit 7d327ba2d55229383435f62e7e39d25e8f693b01
Author: Julien Lepiller <[email protected]>
AuthorDate: Tue Nov 17 14:43:31 2026 +0100

    doc: Reinstate Weblate.
    
    * doc/contributing.texi (Translating Guix): Reinstate Weblate as a way to
    contribute.
    
    Closes: guix/guix#12606
    Merges: guix/guix#12606
---
 doc/contributing.texi | 30 ++++++++++++++++++++++++++----
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index e6819cd1ed1..cdcc341d76f 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -3333,12 +3333,15 @@ 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 used to coordinate the translation effort on a
+We coordinate the translation effort on a
 @uref{https://translate.codeberg.org/projects/guix/,Weblate instance}
 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.
+It is currently configured as invite-only. If you wish to help with the
+translation, please create a ticket on
+@uref{https://codeberg.org/guix/translations/issues/new,the guix/translations
+repository} and make yourself known. Alternatively, translations of Guix itself
+can also be contributed as pull requests on that repository.
 
 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
@@ -3368,19 +3371,38 @@ Guix has five components hosted on
 
 @subsubheading General Directions
 
+Once you get an account, and it is approved for contributing on Weblate, 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, please
+notify us by creating a new ticket on
+@uref{https://codeberg.org/guix/translations/issues/new,the guix/translations
+repository}.
+
 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.  Translators can use any of various
+editor but with PO editing software.   Weblate integrates PO editing
+functionality.  Alternatively, translators can use any of the various
 free-software tools for filling in translations, of which
 @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.
 
+When modifying a file outside of Weblate, it can be contributed either by
+@uref{https://docs.weblate.org/en/latest/user/files.html,uploading it to 
Weblate}
+or by submitting a pull request.
+
+
+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

Reply via email to