Re: build-system design document: how relevant is it now?
Norman Ramsey writes: > I'm trawling the GHC wiki looking for things that will help > me understand how the build system works and what might need > to change for cross-compilation. I stumbled across > https://gitlab.haskell.org/ghc/ghc/-/wikis/design/build-system > which git helpfully tells me dates from 2008. I assume that > none of it is relevant any longer. > Somewhat surprisingly, the document is still largely accurate. However, I suspect that it is redundant given the rather significant body of build system documentation in the Wiki's Commentary. Ultimately all of this build system documentation will hopefully be obsoleted with the removal of the make build system in favor of Hadrian. It's hard to know what to do in cases like this. There is likely still archival value in this documentation but as archival documentation accrues the signal-to-noise ratio of the entire body of documentation falls. I am hope that we can avoid this in the future by erring towards keeping documentation in the repository, where it is easier to ensure that documentation tracks changes in the implementation that it describes. Cheers, - Ben signature.asc Description: PGP signature ___ ghc-devs mailing list ghc-devs@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
RE: build-system design document: how relevant is it now?
It's already a sub-tree of "attic" -- ie out of date, retained for archive. The title index is useful: https://gitlab.haskell.org/ghc/ghc/-/wikis/index Maybe "attic" isn't the best name. Maybe each page should have a header saying "Historical value only". But I hate the idea of outright deletion! Simon PS: I am leaving Microsoft at the end of November 2021, at which point simo...@microsoft.com will cease to work. Use simon.peytonjo...@gmail.com instead. (For now, it just forwards to simo...@microsoft.com.) | -Original Message- | From: ghc-devs On Behalf Of Norman | Ramsey | Sent: 22 October 2021 20:50 | To: ghc-devs@haskell.org | Subject: build-system design document: how relevant is it now? | | | I'm trawling the GHC wiki looking for things that will help me | understand how the build system works and what might need to change | for cross-compilation. I stumbled across | https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgitl | ab.haskell.org%2Fghc%2Fghc%2F-%2Fwikis%2Fdesign%2Fbuild- | systemdata=04%7C01%7Csimonpj%40microsoft.com%7C4c127b6d7e8f4b6008 | 9708d995953f60%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C6377052911 | 25359257%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiL | CJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000sdata=e3MIn5ElWrtNmCC9u4uOP%2 | BQGcx4lU%2FFI8QfxQ0%2FbyOM%3Dreserved=0 | which git helpfully tells me dates from 2008. I assume that none of | it is relevant any longer. | | In its current form, the page seems only likely to confuse future | contributors. I'd rather not leave things that way. Does the page | have archival value? Is there a directory of legacy pages to which I | should move it? Or shall I just delete the current text and replace | it with a short note? Or what? | | | Norman | | ___ | ghc-devs mailing list | ghc-devs@haskell.org | https://nam06.safelinks.protection.outlook.com/?url=http%3A%2F%2Fmail. | haskell.org%2Fcgi-bin%2Fmailman%2Flistinfo%2Fghc- | devsdata=04%7C01%7Csimonpj%40microsoft.com%7C4c127b6d7e8f4b600897 | 08d995953f60%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C637705291125 | 359257%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJ | BTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000sdata=m8dQ5eHD%2Ba0FoK9IFXM7z38 | ehaAg75I9wj2ESNQZaJM%3Dreserved=0 ___ ghc-devs mailing list ghc-devs@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
