first cut at maintainer documentation

[geekosaur]

Highly incomplete, but open to additions.
Also move things from the contributor guide and a few things to it, and absorb the old maintainers list.

---

Template B: This PR does not modify behaviour or interface

E.g. the PR only touches documentation or tests, does refactorings, etc.

Include the following checklist in your PR:

• Patches conform to the coding conventions.
• Is this a PR that fixes CI? If so, it will need to be backported to older cabal release branches (ask maintainers for directions).

[Mikolaj]

I don't ATM have the time to read thoroughly and make suggestions, but this is a great start!

[philderbeast]

I couldn't leave a review without a comment, seems too much to ask when all I found was a comnstraints typo.

[Mikolaj]

Please add a big note at the top saying "if you are a cabal dev, you don't need to read this, at least until you need to escalate anything...".

[geekosaur]

That comment already existed. I added that the only thing of interest was the list of maintainers, which is now the immediately following entry.

[geekosaur]

I am moderately annoyed that the ability to view the file tree associated with a PR seems to have been removed. (Specifically, I want to see how GitHub renders the document.) Thanks yet again for being "useful", GitHub.

---

ETA: found a way to do it still, on the "Commits" tab.

[ulysses4ever]

Was it really necessary to rename the file with the list of maintainers? I referenced it in many places already. I’d really appreciate it if the name could stay the same.

PS I still see the file tree at the same spot as before, on the Files changed tab on the left.

[geekosaur]

I can stick a pointer there, or rename this file again; I was under the impression from Mikołaj's comments on the call that he wanted them to be integrated (specifically, that the list of maintainers should be at the top of this file). And nobody protested when I suggested CABAL-MAINTAINERS.md for this one, to make it clearer that this isn't intended for contributors.

[geekosaur]

Oh, I'm still running the preview; it hasn't been rolled out generally yet. Expect yours to go away when they do.

[ulysses4ever]

he wanted them to be integrated

This is a marvelous idea! I'm all for it. Just leave the old file name.

[geekosaur]

Most recent push renamed it.