From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id kPM0JBj/W18NDQAA0tVLHw (envelope-from ) for ; Fri, 11 Sep 2020 22:50:00 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id mHl6Hhj/W1+wcQAAbx9fmQ (envelope-from ) for ; Fri, 11 Sep 2020 22:50:00 +0000 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 396459408E7 for ; Fri, 11 Sep 2020 22:49:58 +0000 (UTC) Received: from localhost ([::1]:59010 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kGrrh-0006F6-1l for larch@yhetil.org; Fri, 11 Sep 2020 18:49:57 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54034) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kGrrZ-0006Ej-4W for guix-devel@gnu.org; Fri, 11 Sep 2020 18:49:49 -0400 Received: from mail-qk1-x734.google.com ([2607:f8b0:4864:20::734]:35432) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kGrrX-0001Cb-Ew for guix-devel@gnu.org; Fri, 11 Sep 2020 18:49:48 -0400 Received: by mail-qk1-x734.google.com with SMTP id q5so11519261qkc.2 for ; Fri, 11 Sep 2020 15:49:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=7qM5aWdg4zUzak7jWvq5Dv3S0c5z9b3+8zxUPTHAm9I=; b=oN8lqbF+X0PBE0NXq5eDudHQBkcTwACrmY+uhBwjqyn2hX7r5ZIF/w0npWirhghQsp tgPMMm6ym1Tpmmmd13qn4NuF+fg2FW/6171iev2ly2ws9bDPfXQRXJ0p0j99ZJULef8w 7mI++LRlpGay3w7y/ymijNtIX5xTtK3rJdDHqhjtjBnDpzRnKBedfZJdDnGEVLTnN1Do exiZnqIh/AS7qxkRRqM+Os41K1H7yIkfSrDktSNG7QXBjL+pxl7J1zMxmYmekhIrO3MC M7dH+uKVO3Y+VLofNDW+F6GcP7vi3qoyWgn85iY3rnZlJcM4jFCyouHYZcUizbwgw8QZ NOHw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=7qM5aWdg4zUzak7jWvq5Dv3S0c5z9b3+8zxUPTHAm9I=; b=fQXyDhC1O3CqHGZTWp07ydvY3Ak86ztrI2PEyRmA2UfwIEJX3JlaSy5C/mN7BIwYm3 oCJvi8/dPi1Ut7VSmih9uqe49dz7AJOcECSzYDdlclQnvnMHR4LGlFKTzpExIU7INXra l1gGH1FogotPeWjhh0O7O9ghk1XNyEnRz3q7S3ZiDRo19OlmfXnplm90Zu2brayOcAlH dDdp4s+mamkDP79xNypL1J1PvyTmMUmZzJyYHc6db99WrlGBpUA8vaGfZTP/W4E4yF4Z rvH2oN7Jb/VYXUVpx/cxfydtiWj0GOf0kHqroGoFWkeIOh+xT0MK5EakOvoWs/FTQJXo PSWQ== X-Gm-Message-State: AOAM5335yWGdELzXPn3Crl2xwTf+/m8OuMUFidm/oeMcdpg98HCY8Rzq pGcdacT6IdV1wAJq+gyHa5ZxfafWHxlA1wFlLBult8zDmwE= X-Google-Smtp-Source: ABdhPJysXKtddWZ2s9UasIEd2MselQsUQj8RepbjxJ7ynrI1ciC03CrLjeIRMNqZEtM+ewgCQ8yDVG5mjhFWwpLxvG8= X-Received: by 2002:a05:620a:53a:: with SMTP id h26mr3659413qkh.232.1599864585867; Fri, 11 Sep 2020 15:49:45 -0700 (PDT) MIME-Version: 1.0 From: zimoun Date: Sat, 12 Sep 2020 00:49:34 +0200 Message-ID: Subject: doc: Channel subsection order? To: Guix Devel Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=2607:f8b0:4864:20::734; envelope-from=zimon.toutoune@gmail.com; helo=mail-qk1-x734.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=oN8lqbF+; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Spam-Score: -0.71 X-TUID: 9g5bfq2QXI48 Dear, I was re-reading the section about Channels and the subsections do not appear to me "logical". Currently, it is: 1. Channel Authentication 2. Using a Custom Guix Channel 3. Specifying Additional Channels 4. Declaring Channel Dependencies 5. Package Modules in a Sub-directory 6. Specifying Channel Authorizations 7. Primary URL 8. Writing Channel News 9. Replicating Guix and to me, the progression when reading is smoother with this order: 1. Using a Custom Guix Channel 2. Specifying Additional Channels 3. Channel Authentication 4. Declaring Channel Dependencies etc. The examples read more naturally: #1 ;; Tell 'guix pull' to use my own repo. (list (channel (name 'guix) (url "https://example.org/my-guix.git") (branch "super-hacks"))) #2 ;; Add my personal packages to those Guix provides. (cons (channel (name 'my-personal-packages) (url "https://example.org/personal-packages.git")) %default-channels) #3 (channel (name 'my-channel) (url "https://example.org/my-channel.git") (introduction (make-channel-introduction "6f0d8cc0d88abb59c324b2990bfee2876016bb86" (openpgp-fingerprint "CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5")))) than: starts by #3 and goes to #1 after. Other said, starting by Authentication gives the false impression that Channels have to be authenticated (with gpg keys and so on); which means (at least to me): it is complicated. And it is not, both: necessarily authenticated and complicated. : -) All the best, simon