From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id OIGMN2LwUGMm/QAAbAwnHQ (envelope-from ) for ; Thu, 20 Oct 2022 08:53:22 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id iGKIN2LwUGNNBwAAauVa8A (envelope-from ) for ; Thu, 20 Oct 2022 08:53:22 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 8721D80DB for ; Thu, 20 Oct 2022 08:53:22 +0200 (CEST) Received: from localhost ([::1]:56392 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1olPQf-0005nw-0M for larch@yhetil.org; Thu, 20 Oct 2022 02:53:21 -0400 Received: from [::1] (port=43866 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1olP6o-0001B8-HU for larch@yhetil.org; Thu, 20 Oct 2022 02:32:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37366) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1olP59-00016s-FT for guix-patches@gnu.org; Thu, 20 Oct 2022 02:31:12 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:33669) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1olP54-00049g-03 for guix-patches@gnu.org; Thu, 20 Oct 2022 02:31:05 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1olP53-0002li-PG for guix-patches@gnu.org; Thu, 20 Oct 2022 02:31:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#58463] [PATCH] * doc: guix-cookbook: Add a "Guix API usage examples" Resent-From: Liliana Marie Prikler Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 20 Oct 2022 06:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 58463 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: zimoun , Fulbert , 58463@debbugs.gnu.org Received: via spool by 58463-submit@debbugs.gnu.org id=B58463.166624744110597 (code B ref 58463); Thu, 20 Oct 2022 06:31:01 +0000 Received: (at 58463) by debbugs.gnu.org; 20 Oct 2022 06:30:41 +0000 Received: from localhost ([127.0.0.1]:60974 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1olP4j-0002kq-9y for submit@debbugs.gnu.org; Thu, 20 Oct 2022 02:30:41 -0400 Received: from mailrelay.tugraz.at ([129.27.2.202]:7775) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1olP4b-0002kc-Pm for 58463@debbugs.gnu.org; Thu, 20 Oct 2022 02:30:40 -0400 Received: from lprikler-laptop.ist.intra (gw.ist.tugraz.at [129.27.202.101]) by mailrelay.tugraz.at (Postfix) with ESMTPSA id 4MtHln69Dhz3wVf; Thu, 20 Oct 2022 08:30:29 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tugraz.at; s=mailrelay; t=1666247430; bh=GoYqSNTXAIAnTvoDr+ILicDpg/1QphTHqEouRlaVBzo=; h=Subject:From:To:Date:In-Reply-To:References; b=q+qFvZfX6kGJanBUfiyHb7OXQYkZd6U3zPpgUnOhJDilpZLUslqo7hWkYIhPVGmly tEw3Go/uI8xhzs2Bq1GQMd8OgUi5d75AoDV5GWUUc6+9gMmr91KMiBXOiGiTNrGzIY VdzrwiGva0c03MnTJcwVrYZnDp5oBk5jGYRd6x9Y= Message-ID: <88c58e9fe09076e2ea7e29d1424c8f6e47c7d9a8.camel@ist.tugraz.at> From: Liliana Marie Prikler Date: Thu, 20 Oct 2022 08:30:28 +0200 In-Reply-To: <864jw0p1ag.fsf@gmail.com> References: <864jw0p1ag.fsf@gmail.com> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.46.0 MIME-Version: 1.0 X-TUG-Backscatter-control: waObeELIUl4ypBWmcn/8wQ X-Scanned-By: MIMEDefang 2.74 on 129.27.10.116 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1666248802; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=GoYqSNTXAIAnTvoDr+ILicDpg/1QphTHqEouRlaVBzo=; b=l1/qqkw5gP32VXDUNgKLeCvV3jrXC8o128TzBwSA3R8mU7v1BgMp6HK4nEblHc5KDuzc/Q NUhHuhHo7Vk6yDLSpeyxNczIMMKJnAZo2/pycTwVkFqT+8CS6JzwEWYswq100t3yNOH+7F bl1RGkpzt8MCpSvZvQyYVBPOCev5dtOLx9q11JbOxpm2Dk9tzqB6Jr0bF8BKz0jG+q4RG2 ofRVDcoOTt3/NMuYv8AH+VniloOozc0Cr2gWEZ+0VvKxlrfs2gcdbctBRALynIDbRUTTjs 7WGOv4ebkf188AL10iXBtVlXZCr5y6o5ly7xLdW2G+TmqfrsxwnEKwXxaTeKRA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666248802; a=rsa-sha256; cv=none; b=eSd83MbrTOsm6c5mtXoJi5KSew1ypfPXLwHYBN97MOvoYryS+6//fdXeAI++vqfqcHKq9j mDbiu4+rl/N3juzITHiuyVE3EDRvMLl7gtOxPMDHpZQWfVfsUyV08R9CBtY1aXHgS2MSlO R/yMmrOJ/7T/+wM9aUe99nXFqDc2fQMsjVR56FazRTQ7lT/40pQwBmMHzZcemCUc9jFED4 rO44t2sq4auv899tded/76ycakOvZyMdBBVm0ACmUMG//IwAWpj3vh94vFSIl5eLnKyrn+ PIw6TmaXB+m+p5AaGHF1e4RotVv1accsOobuK2ltS+RpZsYEc4Q1K1YpaiWzxA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tugraz.at header.s=mailrelay header.b=q+qFvZfX; dmarc=fail reason="SPF not aligned (relaxed)" header.from=tugraz.at (policy=none); spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: 4.97 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tugraz.at header.s=mailrelay header.b=q+qFvZfX; dmarc=fail reason="SPF not aligned (relaxed)" header.from=tugraz.at (policy=none); spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 8721D80DB X-Spam-Score: 4.97 X-Migadu-Scanner: scn0.migadu.com X-TUID: sAUQ571oQbCG Am Mittwoch, dem 19.10.2022 um 12:15 +0200 schrieb zimoun: > Hi Liliana, >=20 > On Tue, 18 Oct 2022 at 14:09, Liliana Marie Prikler > wrote: >=20 > > I don't think it's useful to write out these timestamps in a way > > that they're readable to the reader.=C2=A0 They might be fine as > > comments, but I'd also suggest diverging from simon's structure to > > accomodate the switch in media (and possibly target audience?) >=20 > What do you mean with >=20 > =C2=A0=C2=A0=C2=A0 I'd also suggest diverging from simon's structure to a= ccomodate > the switch in media (and possibly target audience?) >=20 > ?=C2=A0 The path =E2=80=9Cguix repl=E2=80=9D -> script -> extension appea= rs to me a nice > journey.=C2=A0 What would be your suggestion? I don't have any problem with this part of the structure, the problem arises when making a literal transcription of the slides. Revealing information bit by bit and piecing things together slowly works great in presentation where these bits of information can be augmented by your speech and questions asked in between. In a manual (or cookbook) however, it makes more sense to first show the complete product and then deconstruct it into its parts. Cheers