From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: Guix cookbook (was: guile scheme tutorial) Date: Wed, 08 May 2019 22:21:15 +0200 Message-ID: <871s18elz8.fsf@elephly.net> References: <60f73aa7-e1ae-2c5d-cf47-c179a54a65ce@s.rendaw.me> <87pnoy7g1c.fsf@gnu.org> <3b95f670-336a-c7e9-b2e0-768e2bb99342@s.rendaw.me> <87ftppxgfi.fsf@gnu.org> <871s19w0ik.fsf@ambrevar.xyz> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([209.51.188.92]:47874) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hOT4M-0004i9-90 for help-guix@gnu.org; Wed, 08 May 2019 16:21:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hOT4L-0002FH-3a for help-guix@gnu.org; Wed, 08 May 2019 16:21:38 -0400 In-reply-to: <871s19w0ik.fsf@ambrevar.xyz> List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org Sender: "Help-Guix" To: help-guix@gnu.org Cc: rendaw <7e9wc56emjakcm@s.rendaw.me> Pierre Neidhardt writes: > A well written manual might not be the only answer we are looking for. H= ow > do we teach complex concepts in schools? With examples and exercises. > Maybe we should do that. Blog articles could be a good fit. I=E2=80=99m not a fan of blog posts for teaching, because they quickly lose relevance. An example: recently someone on IRC said they were following your packaging tutorial and something wasn=E2=80=99t working; someone else = then said that the blog post was outdated. I don=E2=80=99t recall the details, = but I find this worrying, because people might spend time learning something from blog posts only to have to unlearn things again. Blog posts are great for outreach and to spawn contemporary discussions. But I think that ultimately we should enhance the manual. We are not limited to having just one document that needs to meet all requirements. We can have more than one thing. Previously, we floated the idea of having a Guix cookbook with short tutorials showing how to achieve well-defined tasks such as writing a package (i.e. an updated and distilled version of your blog post perhaps), setting up a bluetooth-enabled MPD-powered media workstation, configuring a complex web application with database, web server, etc. I=E2=80=99d really like to see such a cookbook become part of Guix. It wou= ld always be up-to-date and it can provide much needed examples that might otherwise clutter up the manual. What do you think? Shall we start with converting your packaging tutorial? -- Ricardo