Sammy Kaye Powers wrote on 10/02/2016 23:01:
Thanks so much for taking this up Derick! :)
The mission points could be reworked a bit.
* Make everybody happier, especially those responsible for developing PHP
itself.
This has a slight insinuation that non-internals/new people are
annoying to the core PHP team. Also, what makes one happy really
varies from person to person so this should be more specific. This
point should be moved to the bottom of the list and read:
"To level the expectations of everyone involved in order to reduce
unnecessary friction and improve the overall efficiency of the PHP
internals community".
This sounds too much like a business's PR-approved Mission Statement to
me, "leverage the synergies of our contributors to deliver value while
maintaining ... what was I talking about again?". I take your point
about it sounding a bit exclusionary, but no reason it can't be kept
snappy and informal:
* "Make us all happier when we're working together to improve PHP."
* Help in making sure we all use our time more efficiently.
How about: "To create an efficient and inviting collaboration
environment" (This should be the first point)
This seems to de-emphasise the "efficiency", and couch it in unnecessary
formalities. I'm not sure what's wrong with the current wording.
* Prevent you from making a fool of yourself in public.
This one sounds angry. :) This would be better: "To lower the learning
curve for new potential contributors by aggregating tribal knowledge"
I think it's supposed to be jokey. Maybe the "you" could be "us" to be a
bit more humble? ("Prevent us making fools of ourselves in public.")
* Increase the general level of goodwill on planet Earth.
That seems a bit out of scope. :) I'd just remove this point.
Again, I think you're taking it too seriously. This isn't intended to
read like a contract. I take this point to mean "we're not just telling
you to do these things because we like making up rules, we're trying to
make everyone happier".
Lastly the overall tone of the document could be bit more inviting,
especially since I can see this document being the entry point for new
contributors getting involved.
The changes you've suggested above seem to me to completely contradict
this one - you've suggested extremely formal and verbose wording to
replace punchy, jokey, points. It maybe needs a bit more "us" rather
than "you", but ultimately, it's a bunch of dos and don'ts, so there's
only so far it can go in placating a nervous reader.
Regards,
--
Rowan Collins
[IMSoP]
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
