Alex Kost <alezost@gmail.com> skribis:

> Ludovic Courtès (2015-12-18 01:23 +0300) wrote:
>
>> Hi Alex!
>>
>> Sorry for the late reply.  I wanted to take the time to sit back, relax,
>> and enjoy the new stuff…  and I haven’t been disappointed!  :-)
>
> Great, thanks for giving your time to this!
>
>> This is awesome.  Some queries seem to take longer on Hydra than others
>> (for instance, getting the list of builds of a given jobset is slow,
>> whereas getting the list of latest builds, queued builds, etc. is pretty
>> fast.)
>
> Yes, I also noticed that processing complex queries takes longer time.
> Perhaps SQL queries that stand behind this Hydra API are not efficient,
> dunno :-)
>
>> Perhaps one small improvement would be to add links from Package Info
>> buffers to the corresponding Guix Hydra Build Info?
>
> Do you mean a button that will do the same as "B" key in "Package List"?
>
> Anyway, I think eventually I'll add more various buttons to "Package
> Info" buffers (like "Hydra Builds", "Build Log", "Size", "Graph"), and
> more keys to "Package List" buffers for the same things.
>
>> I haven’t looked at the code yet, but it’s your area of expertise and
>> I’m confident.  :-)  I skim over it when you think it’s ready; are there
>> parts you’d like to be reviewed more carefully?
>
> Well, I always feel uncomfortable with commit messages.  But I think the
> main part that should be reviewed is documentation (in commit 731f5e4).

So, regarding the documentation:

  +@node Emacs Hydra
  +@section Hydra
  +
  +Guix also provides an interface for @code{hydra.gnu.org} (Guix build
  +farm) that allows to display Hydra builds and jobsets.  This interface
  +is mostly the same as the ``list''/``info'' interface for displaying
  +packages and generations (@pxref{Emacs Package Management}).

I would suggest adding a bit of context, like this:

  The continuous integration server at @code{hydra.gnu.org} builds all
  the distribution packages on the supported architectures and serves
  them as substitutes (@pxref{Substitutes}).  Continuous integration is
  currently orchestrated by @uref{https://nixos.org/hydra/, Hydra}.

  This section describes an Emacs interface to query Hydra to know the
  build status of specific packages, discover recent and ongoing builds,
  view build logs, and so on.  This interface is mostly the same as …

WDYT?

I would also add a cross-reference like: