<div dir="ltr"><div>If you got the readthedocs site working, that does provide per-PR previews of the built documentation relatively easily.</div><div><br></div><div>M<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jan 23, 2024 at 8:37 AM Tom Ellis <<a href="mailto:tom-lists-haskell-cafe-2023@jaguarpaw.co.uk">tom-lists-haskell-cafe-2023@jaguarpaw.co.uk</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Mon, Jan 22, 2024 at 08:30:47PM -0500, Ben Gamari wrote:<br>
> > On 22/01/2024 16:15, Simon Peyton Jones wrote:<br>
> >> Is there any workaround at all?   E.g. a web site where you can give it <br>
> >> a URL for a RST file,  and it'll typeset the RST for you?  Or is it <br>
> >> impossible to to typeset RST?<br>
> ><br>
> > I tend to use pandoc to preview RST files locally. There are also a few <br>
> > websites that allow you to enter RST content directly and see a live <br>
> > preview (e.g. <a href="https://snippets.documatt.com/" rel="noreferrer" target="_blank">https://snippets.documatt.com/</a>). They may not exactly line <br>
> > up with how GitHub renders things, of course, and I don't know of any <br>
> > that let you feed in a URL to an RST file hosted elsewhere.<br>
> ><br>
> As noted during the SWG meeting today, I suspect that the easiest way<br>
> forward here may be to just render PRs via CI. However, I don't know how<br>
> easy it is to preserve artifacts such that they are viewable using<br>
> GitHub Actions. Jose will have a quick look at this.<br>
<br>
Perhaps the artifacts could be deployed as Github Pages.  But in the<br>
first instance I like Bryan's suggestion of just splitting the<br>
documents into small-enough pieces.<br>
_______________________________________________<br>
ghc-devs mailing list<br>
<a href="mailto:ghc-devs@haskell.org" target="_blank">ghc-devs@haskell.org</a><br>
<a href="http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs" rel="noreferrer" target="_blank">http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs</a><br>
</blockquote></div>