<div dir="ltr">For what it's worth, Cabal is now recommending that migration information be included in PRs' changelog entries.</div><br><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">On Thu, Dec 5, 2024 at 4:40 AM Teofil Camarasu <<a href="mailto:teofilcamarasu@gmail.com">teofilcamarasu@gmail.com</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"><div dir="ltr"><div>Hi folks,</div><div><br></div><div>With GHC 9.12 around the corner, I just wanted to give folks a gentle nudge to continue filling out the <a href="https://gitlab.haskell.org/ghc/ghc/-/wikis/migration/9.12" target="_blank">9.12 migration guide</a>.<br></div><div><br></div><div>Ideally we would have an entry for each change that can break user code.</div><div>And each entry would explain:</div><div>- what the change is</div><div>- what error messages caused by the change look like</div><div>- how users can fix their code</div><div><br></div><div>Though if you are aware of a breaking change and don't have the time to fill out a full entry, a stub is also appreciated and I (or someone else) can try to fill out the rest.</div><div><br></div><div>I was also wondering if we should better integrate the migration guide into our processes. Maybe it should be mentioned in the MR template, so entries are added as part of the MR flow?</div><div>I think that's the point when folks have stuff paged in and have the most context, but I also don't want to add extra hoops to jump through. Any thoughts?<br></div><div><br></div><div>Cheers,</div><div>Teo<br></div></div>
_______________________________________________<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><div><br clear="all"></div><div><br></div><span class="gmail_signature_prefix">-- </span><br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>brandon s allbery kf8nh</div><div><a href="mailto:allbery.b@gmail.com" target="_blank">allbery.b@gmail.com</a></div></div></div></div></div>