[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug#43482] [PATCH 3/3] doc: Reorder the "Channels" section.
From: |
zimoun |
Subject: |
[bug#43482] [PATCH 3/3] doc: Reorder the "Channels" section. |
Date: |
Thu, 24 Sep 2020 17:13:02 +0200 |
Hi,
Thank you for the review.
On Thu, 24 Sep 2020 at 16:59, Ludovic Courtès <ludo@gnu.org> wrote:
> > * doc/guix.texi (Channels): Reorder the section.
> > Minor tweaks to keep uniformity.
> > Update the master menu.
>
> It would be nice if you could better describe what’s moved where since
> looking at the diff doesn’t help understand it.
I will try to do my best. :-)
> > +@node Writing custom channels
> > +@subsection Writing custom channels
>
> Should be “Writing Custom Channels”.
>
> Maybe “Creating a Channel” is more to the point actually?
Ok.
> > +Last, as a channel author, you may want to run an authenticated channel
> > +(@pxref{Channel Authentication}), then @pxref{Specifying Channel
> > +Authorizations} for details.
>
> Maybe something like:
>
> As a channel author, consider bundling authentication material with
> your channel so that users can authenticate it. @xref{Channel
> Authentication}, and @ref{Specifying Channel Authorizations}, for
> info on how to do it.
Ok.
> (Note: @pxref cannot be used in the middle of a sentence like you did
> above. I always end up re-reading the Texinfo manual to find which
> cross-reference command to use in which context…)
Thanks for the explanations.
> Could you send updated patches?
Ok.
Cheers,
simon
[bug#43482] [PATCH 1/3] doc: Update the master menu., Ludovic Courtès, 2020/09/24
[bug#43482] [PATCH v2 1/2] doc: Update the master menu., zimoun, 2020/09/25