build-system design document: how relevant is it now?

[Simon Peyton Jones]

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 simonpj at microsoft.com will cease to work.  Use simon.peytonjones at gmail.com instead.  (For now, it just forwards to simonpj at microsoft.com.)

|  -----Original Message-----
|  From: ghc-devs <ghc-devs-bounces at haskell.org> On Behalf Of Norman
|  Ramsey
|  Sent: 22 October 2021 20:50
|  To: ghc-devs at 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-
|  system&data=04%7C01%7Csimonpj%40microsoft.com%7C4c127b6d7e8f4b6008
|  9708d995953f60%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C6377052911
|  25359257%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiL
|  CJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000&sdata=e3MIn5ElWrtNmCC9u4uOP%2
|  BQGcx4lU%2FFI8QfxQ0%2FbyOM%3D&reserved=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 at haskell.org
|  https://nam06.safelinks.protection.outlook.com/?url=http%3A%2F%2Fmail.
|  haskell.org%2Fcgi-bin%2Fmailman%2Flistinfo%2Fghc-
|  devs&data=04%7C01%7Csimonpj%40microsoft.com%7C4c127b6d7e8f4b600897
|  08d995953f60%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C637705291125
|  359257%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJ
|  BTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000&sdata=m8dQ5eHD%2Ba0FoK9IFXM7z38
|  ehaAg75I9wj2ESNQZaJM%3D&reserved=0