--
You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email to php-fig+u...@googlegroups.com.
To post to this group, send email to php...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
FYI: This thread is discussing processes in more broad terms than just the question of if/how changes to PSRs can be done.
Here's the document Paul was talking about:
https://gist.github.com/bobthecow/8eba98be4acf52e8866a
Inline below to save you a click:
Revise the FIG mission statement, and do user testing on it, until it's clear what the FIG is and what it's trying to do.
Come up with some well-written FAQ entries about the FIG and its mission, common misconceptions, the PSR process, etc. When one of them comes up in a pull request or on the mailing list, point users to the FAQ entry.
Rename the standards
repo to php-fig/psrs
.
Make a concerted effort to refer to PSRs as Recommendations not Standards.
Add a CONTRIBUTING.md
file to the psrs
repo. Include a summary of how to get involved with FIG: contributing, requesting membership, discussing (mailing list only, of course) and proposing PSRs. Include a bunch of links to FAQ entries and bylaws for more info.
(possibly?) Disable issues on the psrs
repo. Pull requests will still work, but it will discourage creating issues and discussion there and encourage it on the mailing list.
Appoint a couple of people as moderators of the GitHubs. Write up some rules about how people can interact on GitHub issues and PRs, post the rules in a public place, and grant moderators authority to enforce them.
The moderators' prime directive is to facilitate helpful discussion (read: move it to the mailing list), inform n00bs, and enforce FIG processes.
Everything they do must be completely transparent. They must enforce only rules which have been explicitly spelled out (or linked to) in CONTRIBUTING.md
. If they delete comments, they should probably Gist the conversation and link to it in a comment:
Please continue this discussion on the mailing list: {thread link}
Off-topic comments have been archived {gist link} and removed.
They should be helpful, supportive and nice while doing this. This means that they prolly should not delete the first off-topic comment on a pull request, but should remind users of the appropriate ways to interact.
Moderators should apply the "broken window theory" to the discussion on issues and pull requests. If it is on topic, meaning it's actual comments regarding the content of the request, it can stay, but off-topic conversation, and conversation regarding the merit of the pull request, should be shut down quickly to keep it from getting out of hand. Here's where the moderators would delete comments, close pull requests and issues, etc, and point people to the FAQ, bylaws, CONTRIBUTING.md
and mailing lists.
Pull requests which are invalid should be closed (fairly quickly) with a helpful message:
Revisions to finalized PSRs must follow the following process {link to bylaws}
Feel free to discuss this on the mailing list {link}.
Note that this relies on the bylaws and processes currently under discussion actually getting passed. So let's do that too :)
As long as people engage trolls and off-topic conversation in issues and pull requests, they will keep commenting on issues and pull requests.
This one is in BIG BOLD LETTERS because it is VERY IMPORTANT: We don't want to censor or stifle dissention. We want to redirect to a more useful place.
I would highly suggest not reinventing the wheel here. Take a look at RFC2026, which documents the RFC process: http://www.ietf.org/rfc/rfc2026.txtAlso, check out Python's PEP-1 http://www.python.org/dev/peps/pep-0001/ which basically does the same thing (although isn't nearly as verbose).One of the fundamental points is that after release (approval), no further changes can ever happen. That's absolutely critical.
Justin's recommendation for a Contribution file to help inform the public when and where their input is needed
https://groups.google.com/d/msg/php-fig/-N56pNKtZHE/DvM1ZP2tYosJ
--
You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email to php-fig+u...@googlegroups.com.
To post to this group, send email to php...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msg/php-fig/-/q3ibZIEPgb4J.
> Appoint a couple of people as moderators of the GitHubs. Write up some rules
> about how people can interact on GitHub issues and PRs, post the rules in a
> public place, and grant moderators authority to enforce them.
Completely agreed.
> That last one is a dangerous one, so it gets a couple more points:
>
> The moderators' prime directive is to facilitate helpful discussion (read:
> move it to the mailing list), inform n00bs, and enforce FIG processes.
Agreed.
> Everything they do must be completely transparent. They must enforce only
> rules which have been explicitly spelled out (or linked to) in
> CONTRIBUTING.md. If they delete comments, they should probably Gist the
> conversation and link to it in a comment:
>
> Please continue this discussion on the mailing list: {thread link}
>
> Off-topic comments have been archived {gist link} and removed.
Disagree. If a comment is off-topic we should delete it - not archive
it. If any comment is on-topic it should not need to be archived.
> They should be helpful, supportive and nice while doing this. This means
> that they prolly should not delete the first off-topic comment on a pull
> request, but should remind users of the appropriate ways to interact.
You received this message because you are subscribed to a topic in the Google Groups "PHP Framework Interoperability Group" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/php-fig/BIs5ZyqPc1E/unsubscribe?hl=en.
To unsubscribe from this group and all its topics, send an email to php-fig+u...@googlegroups.com.
--
You received this message because you are subscribed to a topic in the Google Groups "PHP Framework Interoperability Group" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/php-fig/BIs5ZyqPc1E/unsubscribe?hl=en.
To unsubscribe from this group and all its topics, send an email to php-fig+u...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msg/php-fig/-/PcleXz0Je0cJ.
P: I guess next to the whole workflow in general conversation, we need to close down some channels of communication. I've been moderation by proxy through Paul D but issues just not being there would be much better. I'd like some other people's opinions on this.
Amy: it's a good thing I wasn't talking about that PR then :)
P: I guess next to the whole workflow in general conversation, we need to close down some channels of communication. I've been moderation by proxy through Paul D but issues just not being there would be much better. I'd like some other people's opinions on this.
--
You received this message because you are subscribed to a topic in the Google Groups "PHP Framework Interoperability Group" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/php-fig/BIs5ZyqPc1E/unsubscribe?hl=en.
To unsubscribe from this group and all its topics, send an email to php-fig+u...@googlegroups.com.
To post to this group, send email to php...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msg/php-fig/-/hUvG5-QHGU4J.