[Haskell-cafe] is it normal for docs to be pending for 24 hours?

[Patrick Pelletier]

Can you share the list of requested changes?  And what is the cause of 
the difference?  Is Stackage running Haddock with different options than 
Hackage does?  Or is it doing something other than just running 
Haddock?  Is the code that builds the Stackage docs available?

--Patrick


On 11/12/16 10:46 PM, Michael Snoyman wrote:
> I shared this thought privately before, but worth sharing publicly if 
> someone wants to try following up on it: all of the docs build for the 
> Stackage server are available on S3, and could by leveraged by Hackage 
> as well. When I brought this up earlier, there was a large-ish list of 
> requested changes to the generated HTML, which I didn't want to 
> implement, but perhaps someone can find a way to bridge the gap.
>
> On Fri, Nov 11, 2016 at 6:43 PM, Gershom B <gershomb at gmail.com 
> <mailto:gershomb at gmail.com>> wrote:
>
>     Sorry — the builder for docs has been in rough shape and we’re
>     working on it. In this case it got stuck due to disk space issues
>     and monitoring didn’t catch it. Its now running again but doing
>     some catching up. (And lots of stuff in the queue it failed to
>     build due to other problems needs to be replaced there, which is a
>     manual process at the moment if we don’t want the queue as a whole
>     to just drown out any new things at all with backlog). It would be
>     much better to expose more queues and have better monitoring (and
>     real prioritization), and another volunteer to help ben out on
>     this would be very welcome (please contact me if you’re interested
>     — the code lives at
>     https://github.com/haskell/hackage-server/blob/master/BuildClient.hs
>     <https://github.com/haskell/hackage-server/blob/master/BuildClient.hs> and
>     there’s some uncommitted work on queuing as well).
>
>     —gerhsom
>
>     On November 8, 2016 at 8:37:19 PM, Patrick Pelletier
>     (code at funwithsoftware.org <mailto:code at funwithsoftware.org>) wrote:
>     > This is only my second time uploading a package to Hackage, so I
>     don't
>     > yet have a feel for how it's supposed to go. I uploaded
>     > normalization-insensitive-2.0.0.1 about 24 hours ago:
>     >
>     >
>     https://hackage.haskell.org/package/normalization-insensitive-2.0.0.1
>     <https://hackage.haskell.org/package/normalization-insensitive-2.0.0.1>
>     >
>     > Under "Status", it says "Docs pending". (And the module names
>     are all
>     > non-clickable.) Is it normal to take this long to build the docs? Is
>     > there some way to find out where in the queue my job is? Is this an
>     > indication that something has gone wrong? How do I fix it?
>     >
>     > Thanks,
>     >
>     > --Patrick
>     >
>     > _______________________________________________
>     > Haskell-Cafe mailing list
>     > To (un)subscribe, modify options or view archives go to:
>     > http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe
>     <http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe>
>     > Only members subscribed via the mailman list are allowed to post.
>
>     _______________________________________________
>     Haskell-Cafe mailing list
>     To (un)subscribe, modify options or view archives go to:
>     http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe
>     <http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe>
>     Only members subscribed via the mailman list are allowed to post.
>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/haskell-cafe/attachments/20161112/9a0fb4e8/attachment.html>