[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

doc: Channel subsection order?

From: zimoun
Subject: doc: Channel subsection order?
Date: Sat, 12 Sep 2020 00:49:34 +0200


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

The examples read more naturally:

     ;; Tell 'guix pull' to use my own repo.
     (list (channel
             (name 'guix)
             (url "";)
             (branch "super-hacks")))

     ;; Add my personal packages to those Guix provides.
     (cons (channel
             (name 'my-personal-packages)
             (url "";))

       (name 'my-channel)
       (url "";)
          "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,

reply via email to

[Prev in Thread] Current Thread [Next in Thread]