From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "pelzflorian (Florian Pelz)" Newsgroups: gmane.lisp.guile.devel Subject: Re: Translating Guile documentation Date: Sun, 24 Apr 2022 14:11:18 +0200 Message-ID: <20220424121118.yrgq32v36xv54dno@pelzflorian.localdomain> References: <1650751329.684147000.fjrw2sdf@frv50.fwdcdn.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="10050"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guile-devel@gnu.org To: Denys Nykula Original-X-From: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Sun Apr 24 14:11:52 2022 Return-path: Envelope-to: guile-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nib5j-0002OV-3e for guile-devel@m.gmane-mx.org; Sun, 24 Apr 2022 14:11:51 +0200 Original-Received: from localhost ([::1]:48776 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nib5i-0007VY-2H for guile-devel@m.gmane-mx.org; Sun, 24 Apr 2022 08:11:50 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45452) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nib5P-0007VK-6u for guile-devel@gnu.org; Sun, 24 Apr 2022 08:11:31 -0400 Original-Received: from pelzflorian.de ([5.45.111.108]:46202 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nib5M-0001v7-RJ for guile-devel@gnu.org; Sun, 24 Apr 2022 08:11:30 -0400 Original-Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id 58FFC360615; Sun, 24 Apr 2022 14:11:26 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1650802286; bh=8xnf8FVbe5BUvTo4uSosHYR/DbeaOWqh4FARxvkNJ/Q=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=ESzIuxDDYT4t21yLthD4CLawu48zSMawRqiEf04Ye5FOOck/PPmdBCzA3MnHsGSbq EI9Dkr4a20QpdmLRk2MFqsN2KYjAD7FSj84x/ptWCljpmq40vJJlROFnIESARUxLLv 6GlMFpWVg12FX+XLzR6je/Xd6lqummX7ISLTTmOs= Content-Disposition: inline In-Reply-To: <1650751329.684147000.fjrw2sdf@frv50.fwdcdn.com> Received-SPF: pass client-ip=5.45.111.108; envelope-from=pelzflorian@pelzflorian.de; helo=mail.pelzflorian.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Original-Sender: "guile-devel" Xref: news.gmane.io gmane.lisp.guile.devel:21201 Archived-At: Hello Denys. On Sun, Apr 24, 2022 at 01:24:33AM +0300, Denys Nykula wrote: > Hello. > > Have the Guile website and reference manual ever been translated to > languages other than English? If I would like to start translating them > to my primary language, Ukrainian, what should I know in advance? You have a wonderful ambition there. This reminds me of my attempts a long time ago to translate the copy of r5rs that is shipped with Guile to German. https://lists.gnu.org/archive/html/guile-devel/2018-04/msg00007.html Nothing came of it and I don’t know if Guile’s documentation is stable enough. For example, at https://guix.gnu.org/blog/2022/online-guix-days-2022-announcement-2/ there have been discussions about reworking part of the docs. See there at * 13:40–14:15: A Deep Dive into the Guile Documentation & Makeover Proposal In hindsight, I would rather translate the SICP book http://mitpress.mit.edu/sicp/ (which already has been translated to German by Susanne Daniels-Herold, but I think to no other language). I’ve not checked if there are more recent comparable books. Of course, there are SRFIs and Guile specifics beyond SICP, like (ice-9 match). Regards, Florian