From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id uKpXNnNgYl9SNwAA0tVLHw (envelope-from ) for ; Wed, 16 Sep 2020 18:58:59 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id Ti5IMnNgYl+AUgAA1q6Kng (envelope-from ) for ; Wed, 16 Sep 2020 18:58:59 +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 6444A9401D0 for ; Wed, 16 Sep 2020 18:58:59 +0000 (UTC) Received: from localhost ([::1]:58262 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kIcdu-0005U6-9J for larch@yhetil.org; Wed, 16 Sep 2020 14:58:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38458) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kIcdk-0005Tl-N8 for guix-devel@gnu.org; Wed, 16 Sep 2020 14:58:48 -0400 Received: from mail-qv1-xf36.google.com ([2607:f8b0:4864:20::f36]:33397) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kIcdj-0005PM-0U; Wed, 16 Sep 2020 14:58:48 -0400 Received: by mail-qv1-xf36.google.com with SMTP id cy2so4138152qvb.0; Wed, 16 Sep 2020 11:58:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=mw3aIBzSVITh/XNKFV3QxZ/DqhQzBgLALifaaWg6grA=; b=tgbsIqCpDKQfB2wiCKXoMh85VhGByvyZ24gwdO03MN2jVszeRD2jEpOqB02dQ1saEF LS0RZtX71RnQUz/tzlnGyeCPmtIX5ZU5YmJ+5SCB1BtWYSQuQgdzoZBRRSkfhD17XIcU 2dPlaTXDlsaAJZp8tCB0Synp/GCSyn7vFaudagUQ9vcdsmH7t45tlQwQ0S8DdbqMTAGj VRr+VZfeo9aNUQOrJXCeA/4EvVsTbDW/+QYJk8DopCbjCKH2nVEbWQlZ38E8OqRzbiPA 5bwbVLoYtKHELY2ZRpaSBk2Wl2erVg2iBpDQOyF6DcPpI9QzAhudgcgTwMMPsHuO5o1V 9lrQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=mw3aIBzSVITh/XNKFV3QxZ/DqhQzBgLALifaaWg6grA=; b=PbFV0vWegGk965Dvxml5PgQ7vcTIkPkVgvYdphgyzh7bduncaJCUwJovEUbN9v6JyZ sPImioAMHwjqrgU+k6rF/ZHywXozg+HLVzJ7rCzO9HYIIGU2tgxjfmnCosIK7OGMiQoU b1JxBAHLEUNHJDRol37Az7jepUuvWdE5LimOefcBwceOZqBlnudLNk+DYEhY9XaZJVM+ DMdfniF7wwew4WzH/ThPMMuhmtJu4I4KVC5IXjsB16UHn1k+xj4xyolliLnmpUaNEYtP ePq++yShsP4MBIR8PlzvvG+Tm8QddmGhwgCK3Xm9SWoF4adaLYb2ZsORf3f335WJTa6y 6RsA== X-Gm-Message-State: AOAM531W6s2Rt9d2tmyuOjtG38urNxlNfwYyJntEvM33YCY7okelkbXd lOGcNlpzoFhKy0hrQ6jyCOGJyT1nH1OFjmk6sGIvW181abY= X-Google-Smtp-Source: ABdhPJyI6f3QWsjW/57sXX8zwcPfkSote5HJo78/4YMigxh3rN0EGk5AM/+wlGmaxdkqhirqqCwl3hSaUQYI+Rbdfc4= X-Received: by 2002:ad4:58e7:: with SMTP id di7mr8360893qvb.36.1600282725632; Wed, 16 Sep 2020 11:58:45 -0700 (PDT) MIME-Version: 1.0 References: <87een1n0a4.fsf@gnu.org> In-Reply-To: <87een1n0a4.fsf@gnu.org> From: zimoun Date: Wed, 16 Sep 2020 20:58:34 +0200 Message-ID: Subject: Re: doc: Channel subsection order? To: =?UTF-8?Q?Ludovic_Court=C3=A8s?= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::f36; envelope-from=zimon.toutoune@gmail.com; helo=mail-qv1-xf36.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: , Cc: Guix Devel 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=tgbsIqCp; 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: YKis36eb0kWG On Wed, 16 Sep 2020 at 18:40, Ludovic Court=C3=A8s wrote: > I think we should: > > 1. Move =E2=80=9CChannels=E2=80=9D to the top level, with real subsecti= ons as nodes. > > 2. Clearly distinguish between using a channel and developing a > channel. The former should come first. > > 3. Probably move =E2=80=98guix pull=E2=80=99 and =E2=80=98guix time-mac= hine=E2=80=99 under that > section. > > 4. Add a tutorial-like section on how to work on your own channel. > > Thoughts? I agree. Perfect! Does it mean 4 commits? I will try to do something in the next couple of days if no one beats me. Cheers, simon