GHC proposals not rendering
Michael Peyton Jones
me at michaelpj.com
Tue Jan 23 10:16:33 UTC 2024
If you got the readthedocs site working, that does provide per-PR previews
of the built documentation relatively easily.
M
On Tue, Jan 23, 2024 at 8:37 AM Tom Ellis <
tom-lists-haskell-cafe-2023 at jaguarpaw.co.uk> wrote:
> On Mon, Jan 22, 2024 at 08:30:47PM -0500, Ben Gamari wrote:
> > > On 22/01/2024 16:15, Simon Peyton Jones wrote:
> > >> Is there any workaround at all? E.g. a web site where you can give
> it
> > >> a URL for a RST file, and it'll typeset the RST for you? Or is it
> > >> impossible to to typeset RST?
> > >
> > > I tend to use pandoc to preview RST files locally. There are also a
> few
> > > websites that allow you to enter RST content directly and see a live
> > > preview (e.g. https://snippets.documatt.com/). They may not exactly
> line
> > > up with how GitHub renders things, of course, and I don't know of any
> > > that let you feed in a URL to an RST file hosted elsewhere.
> > >
> > As noted during the SWG meeting today, I suspect that the easiest way
> > forward here may be to just render PRs via CI. However, I don't know how
> > easy it is to preserve artifacts such that they are viewable using
> > GitHub Actions. Jose will have a quick look at this.
>
> Perhaps the artifacts could be deployed as Github Pages. But in the
> first instance I like Bryan's suggestion of just splitting the
> documents into small-enough pieces.
> _______________________________________________
> ghc-devs mailing list
> ghc-devs at haskell.org
> http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/ghc-devs/attachments/20240123/355c9422/attachment.html>
More information about the ghc-devs
mailing list