guix-devel
[Top][All Lists]
Advanced

[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

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



reply via email to

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