<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>Teo this is very, very useful. Thank you very much.</p>
    <p>This is going to be very appreciated productivity boost for
      documentation MRs.</p>
    <p>Cheers,</p>
    <p>Hécate<br>
    </p>
    <div class="moz-cite-prefix">Le 30/05/2024 à 00:03, Teofil Camarasu
      a écrit :<br>
    </div>
    <blockquote type="cite"
cite="mid:CAPBO51EB_cJ9gsJJ8aOPXikHGjhb1uQcV321tQqT1wRwx_Lw7g@mail.gmail.com">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      <div dir="ltr">Hi folks,
        <div><br>
        </div>
        <div>I just wanted to advertise that it is now possible to see
          rendered previews of documentation changes (haddocks/user
          guide/etc) on Gitlab pipelines.</div>
        <div><br>
        </div>
        <div>To access this you need to:</div>
        <div>1. Wait for a pipeline to complete.</div>
        <div>2. From the MR page, click on "Expand" under the pipeline
          widget, then "Documentation Preview"</div>
        <div>3. This takes you to the job artefacts. Then open
          `docs/index.html`.</div>
        <div>4. Gitlab will then redirect you to the hosted page.</div>
        <div><br>
        </div>
        <div>Alternatively instead of (2) you can open the
          "docs-tarball" job directly and click on "Browse" to go to the
          artefacts.</div>
        <div><br>
        </div>
        <div>I've also attached a screen recording to make it a bit
          clearer.</div>
        <div><br>
        </div>
        <div>I actually set this up a few weeks ago in <a
href="https://gitlab.haskell.org/ghc/ghc/-/merge_requests/12415"
            moz-do-not-send="true">!12415</a>. But I forgot to advertise
          this more widely at the time. And Gitlab isn't super helpful
          in directing users to it. So, I realised most folks probably
          don't know it exists.</div>
        <div><br>
        </div>
        <div>Cheers,</div>
        <div>Teo</div>
      </div>
      <br>
      <fieldset class="moz-mime-attachment-header"></fieldset>
      <pre class="moz-quote-pre" wrap="">_______________________________________________
ghc-devs mailing list
<a class="moz-txt-link-abbreviated" href="mailto:ghc-devs@haskell.org">ghc-devs@haskell.org</a>
<a class="moz-txt-link-freetext" href="http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs">http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs</a>
</pre>
    </blockquote>
    <pre class="moz-signature" cols="72">-- 
Hécate ✨
🐦: @TechnoEmpress
IRC: Hecate
WWW: <a class="moz-txt-link-freetext" href="https://glitchbra.in">https://glitchbra.in</a>
RUN: BSD</pre>
  </body>
</html>