[ghc-steering-committee] Redid our documentation

[Joachim Breitner]

[I sent this mail from Monday to the wrong address, second try]

Hi,

there was a bit confusion about our documentation, so with SPJ’s
blessing I went ahead and restructured it a bit. For now, this is only
on a branch and not live yet:

https://github.com/ghc-proposals/ghc-proposals/tree/wip/docs-restructur
ing

Note that it starts with a concise timeline of a proposal, and from
there has links to section answering specific questions, within the
same file. What was three files before (README, process, committee) is
now all in here (with the exception of the “detailed instructions” for
the Github-novice, which is in a separate file). This should make it
easier for everyone involved to know who has to do what when.

Our process is, however, flawed: We ask authors to set labels (“Under
Discussion” and “Under Committee Review”), but they do not have
permissions to do so. So this does not quite work.

So I suggest the following change:

 * What was “Under Discussion” is now simply any PR that does not have
any other label. This way, when opening discussion, nothing concrete
has to be done. Which is easier. (GitHub allows to list all PRs that
have no label, so there is no loss in functionality here.)

 * When the author wants to submit the PR, he sends a mail to this
mailinglist (is this set up to accept mails from non-subscribers?) and
it its the task of the shephard to set the label to indicate that that
the committee has accepted to review the proposal. (At this point, the
shephard could for example set the `Out-of-scope` label instead.)


If there are no complains I will adjust the docs-restructuring branch
accordingly and then move that to master.

Greetings,
Joachim



-- 
Joachim “nomeata” Breitner
  mail at joachim-breitner.de • https://www.joachim-breitner.de/
  XMPP: nomeata at joachim-breitner.de • OpenPGP-Key: 0xF0FBF51F
  Debian Developer: nomeata at debian.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <http://mail.haskell.org/pipermail/ghc-steering-committee/attachments/20170225/e9f901ad/attachment.sig>