PHP: email_etiquette_for_people_new_to_php_internals

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Email etiquette for people new to PHP internals ======

As well as a set of [[https://git.php.net/?p=php-src.git;f=docs/mailinglist-rules.md;hb=HEAD|rules]] the PHP mailing lists have a set of etiquette that everyone should be aware of. They are 'etiquette' in the sense they are guidelines, rather than strict rules as to what is and isn't acceptable. 

However if you want to contribute to PHP internals you should be aware of them. 

The core issue that people new to PHP internals should bear in mind is that the mailing list takes up people's time.

Until you understand enough of what is going on, then it's difficult to effectively contribute to PHP internals development.

It is quite easy for new comers to PHP internals to accidentally hinder the project by limiting how useful it is for people who are active PHP contributors, even though people just want to help.

===== Not everyone needs to take part in every conversation. =====


In particular, if you haven't been around in the project to understand what is being discussed, then it's appropriate to only read the messages, rather than getting involved in every conversation.

===== It's appropriate for people new to the group to send fewer messages than core contributors to the project. =====



Although it's great that people new to the PHP internals discussion have lots of energy to discuss things, the mailing list is a tool that aims to help the PHP core developers to coordinate their work.

If people new to PHP internals are sending many messages, it makes it harder for the people doing the work to develop PHP core to communicate effectively with each other.


===== Please take your time before replying. =====


The email mailing list is a different communication method that you may not be used to, particular if you haven't used other newsgroups before.

It is not a chatroom, where you are only talking to a few other people. The messages you send are sent to hundreds of people. When you read a message that you think you could reply to, it is appropriate for you to take your time to fully understand what the other person wrote, and to carefully craft a response that is easy to read.

Additionally, by replying quickly you may be 'jumping ahead' of someone who might be able to respond much more authoritatively, but who only reads the mailing list every evening, or every few days.

It's okay for messages to not be responded to for days.

===== Use fewer words. =====


So that they are easy to read, you should spend time carefully drafting your messages.

Messages that are longer than necessary can take up a lot of other people's time. 

Also, the longer your message is, the less likely it is that other people will bother to read all of it.

If nothing else, if you are receiving an error message from the mail server that your message is too long, you should redraft it to be much shorter.


===== Avoid using jokes, colloquialism, idioms and other 'clever' word techniques to make a point. =====

Trying to 'win' an argument by making an amusing word play is great fun but it is not a good fit for messages that are sent to lots of people, particularly when not everyone on the list has English as their primary language.

Using the simplest and most direct words you can to express yourself will make it much easier for other people to read and understand your messages, which increases the chance your message will have a positive effect.

===== Quote as little as possible from others' messages. =====


In addition to not 'top-posting' (i.e. please put your response below someone else's words you are quoting) cutting down a message you are replying to, so that you only quote the exact words you are replying to, makes it much easier for other people to understand what you are replying to.

A good rule of thumb is, there should not be more quoted text than new text. 

===== It's okay to let conversations end. =====

Not every conversation is going to result in a benefit to PHP. In particular, in situations where for many days a thread has only received messages from people new to PHP, and none of the core developers have participated, you should really be asking yourself "is keeping this thread active going to help the project?".
Page Tools
