<div dir="ltr">Here were Duncan's comments at the time:<div><br><div><span style="font-size:12.8px"> * the docs need to match the URL scheme on hackage, in terms of</span><br style="font-size:12.8px"><span style="font-size:12.8px"> linking back to other packages docs on hackage. This needs to be</span><br style="font-size:12.8px"><span style="font-size:12.8px"> done using sufficiently-relative urls so that http & https</span><br style="font-size:12.8px"><span style="font-size:12.8px"> works.</span><br style="font-size:12.8px"><span style="font-size:12.8px"> * it's generally not desirable to overwrite/replace existing docs.</span><br style="font-size:12.8px"><span style="font-size:12.8px"> You can check which packages are missing docs by consulting this</span><br style="font-size:12.8px"><span style="font-size:12.8px"> resource: </span><a href="http://hackage.haskell.org/packages/docs.json" rel="noreferrer" style="font-size:12.8px" target="_blank">http://hackage.<wbr>haskell.org/packages/docs.json</a><br style="font-size:12.8px"><span style="font-size:12.8px"> * we generate the docs so that only one style is listed, so that</span><br style="font-size:12.8px"><span style="font-size:12.8px"> haddock does not include it's style switcher menu.</span><br style="font-size:12.8px"><span style="font-size:12.8px"> * we do include all the files haddock generates, including the</span><br style="font-size:12.8px"><span style="font-size:12.8px"> minus.gif, synopsis.png.</span><br style="font-size:12.8px"><span style="font-size:12.8px"> * hackage currently does not use a shared haddock css and js file</span><br style="font-size:12.8px"><span style="font-size:12.8px"> (though doing so is a good idea), so these are also included in</span><br style="font-size:12.8px"><span style="font-size:12.8px"> the doc bundle, just as haddock produces them.</span><br></div></div><div><span style="font-size:12.8px"><br></span></div><div><span style="font-size:12.8px">This presumes having some kind of an upload script running from the Stackage side, whereas my recommendation had been that Hackage be modified to use the Stackage S3 docs as a backup for when its doc building fails. You can see an example of generated docs at:</span></div><div><span style="font-size:12.8px"><br></span></div><div><span style="font-size:12.8px"><a href="https://s3.amazonaws.com/haddock.stackage.org/lts-7.0/tagstream-conduit-0.5.5.3/Text-HTML-TagStream-ByteString.html" target="_blank">https://s3.amazonaws.com/<wbr>haddock.stackage.org/lts-7.0/<wbr>tagstream-conduit-0.5.5.3/<wbr>Text-HTML-TagStream-<wbr>ByteString.html</a></span><br></div><div><span style="font-size:12.8px"><br></span></div><div><span style="font-size:12.8px">The code which calls Haddock is available at:</span></div><div><span style="font-size:12.8px"><br></span></div><div><span style="font-size:12.8px"><a href="https://github.com/fpco/stackage-curator/blob/master/Stackage/PerformBuild.hs" target="_blank">https://github.com/fpco/<wbr>stackage-curator/blob/master/<wbr>Stackage/PerformBuild.hs</a></span><br></div><div><span style="font-size:12.8px"><br></span></div><div><span style="font-size:12.8px">By the way, regarding your comments about resourcet and FP Complete: I'm honestly offended at this tone. I've clearly attempted quite often and quite sincerely to get such cooperation to happen, and have been rebuffed. Even if you're unaware of that, the implied accusation assumes a lot which isn't true. I honestly considered ignoring this thread entirely based on this tone, I'm tired of dealing with it.<br></span></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Nov 13, 2016 at 8:59 AM, Patrick Pelletier <span dir="ltr"><<a href="mailto:code@funwithsoftware.org" target="_blank">code@funwithsoftware.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000">
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?<span class="HOEnZb"><font color="#888888"><br>
<br>
--Patrick</font></span><div><div class="h5"><br>
<br>
<br>
<div class="m_-392412028033906457moz-cite-prefix">On 11/12/16 10:46 PM, Michael Snoyman
wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">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.</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On Fri, Nov 11, 2016 at 6:43 PM,
Gershom B <span dir="ltr"><<a href="mailto:gershomb@gmail.com" target="_blank">gershomb@gmail.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">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 <a href="https://github.com/haskell/hackage-server/blob/master/BuildClient.hs" rel="noreferrer" target="_blank">https://github.com/haskell/<wbr>hackage-server/blob/master/Bui<wbr>ldClient.hs</a> and
there’s some uncommitted work on queuing as well).<br>
<br>
—gerhsom<br>
<div class="m_-392412028033906457HOEnZb">
<div class="m_-392412028033906457h5"><br>
On November 8, 2016 at 8:37:19 PM, Patrick Pelletier (<a href="mailto:code@funwithsoftware.org" target="_blank">code@funwithsoftware.org</a>)
wrote:<br>
> This is only my second time uploading a package to
Hackage, so I don't<br>
> yet have a feel for how it's supposed to go. I
uploaded<br>
> normalization-insensitive-2.0.<wbr>0.1 about 24
hours ago:<br>
><br>
> <a href="https://hackage.haskell.org/package/normalization-insensitive-2.0.0.1" rel="noreferrer" target="_blank">https://hackage.haskell.org/pa<wbr>ckage/normalization-insensitiv<wbr>e-2.0.0.1</a><br>
><br>
> Under "Status", it says "Docs pending". (And the
module names are all<br>
> non-clickable.) Is it normal to take this long to
build the docs? Is<br>
> there some way to find out where in the queue my
job is? Is this an<br>
> indication that something has gone wrong? How do I
fix it?<br>
><br>
> Thanks,<br>
><br>
> --Patrick<br>
><br>
> ______________________________<wbr>_________________<br>
> Haskell-Cafe mailing list<br>
> To (un)subscribe, modify options or view archives
go to:<br>
> <a href="http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe" rel="noreferrer" target="_blank">http://mail.haskell.org/cgi-bi<wbr>n/mailman/listinfo/haskell-caf<wbr>e</a><br>
> Only members subscribed via the mailman list are
allowed to post.<br>
<br>
______________________________<wbr>_________________<br>
Haskell-Cafe mailing list<br>
To (un)subscribe, modify options or view archives go to:<br>
<a href="http://mail.haskell.org/cgi-bin/mailman/listinfo/haskell-cafe" rel="noreferrer" target="_blank">http://mail.haskell.org/cgi-bi<wbr>n/mailman/listinfo/haskell-caf<wbr>e</a><br>
Only members subscribed via the mailman list are allowed
to post.</div>
</div>
</blockquote>
</div>
<br>
</div>
</blockquote>
<br>
</div></div></div>
</blockquote></div><br></div>