Matthew, Yes, precisely. I think this is in keeping with the desire to provide a positive tone, suggestive of desired behavior.
"Try to help your audience; your email will be read by hundreds of people, and many people will read only a few lines to decide if they are interested. Do you best to get to the point as fast as you can, so people can see what the email will be about. It is often useful to put a summary of a few lines at the top and then explain your reasoning in more depth below, for people who want to learn more." We could point to a few good examples.
I hope this modification gets closer to convergence. Help your audience. Your email will be read by hundreds of people. You may find summarizing at the beginning and providing fuller explanation of your reasoning below helpful, to yourself as well as your readers. Many people will scan the first few lines to see if the message is pertinent to their interests and expertise. Help them and future readers who may be sifting hundreds of search engine hits. See <URL> for a few select examples. On Tue, Oct 3, 2017 at 5:13 AM, Matthew Brett <matthew.brett@gmail.com> wrote:
On Tue, Oct 3, 2017 at 12:28 AM, Bennet Fauber <bennet@umich.edu> wrote:
I am more a lurker than a contributor, but I would like to suggest caution with respect to item #5 in the proposed CoC.
+5. Be concise. Keep in mind that what you write once will be read by hundreds + of persons. Writing a short email means people can understand the + conversation as efficiently as possible. Short emails should always strive + to be empathetic, welcoming, friendly and patient. When a long explanation + is necessary, consider adding a summary.
I suggest that you should stress more that people should strive for clarity and completeness, and then say that brief and comprehensive is the desired goal. I think you're leaning on short too hard, and that will encourage incomplete more than real concision.
There are my reasons: 1) one person's concise could well be another's incomplete. 2) There are many, many terms that have more than one use, or that have different meanings in different contexts, or may have connotations; sometimes being concise leads to use of seemingly unambiguous terms that do turn out to be ambiguous.
For those who would reply that the definition of 'concise' implies completeness, as in the definition given:
giving a lot of information clearly and in a few words; brief but comprehensive.
In popular speech, and to those who may have been over-exposed to some kinds of management, concise is more likely to be interpreted as 'abbreviated', which highlights my second point above. I myself often interpret 'concise' to mean 'short' and often 'abbreviated', because that is what I have (alas) become accustomed to in my work environment.
Language evolved to have a lot of redundancy built into it for a reason. Stripping it of too much is as bad as including too much.
I hope I was sufficiently concise. ;-)
I agree with the general idea. Concise emails can be very intimidating, as in "it's so obvious you are wrong I can't be bothered to explain why". It's can also be an alienating sign, as in "I'm so senior here that there is no need for me to explain my reasoning".
Maybe a better way to put it, is something like "Try to help your audience; your email will be read by hundreds of people, and many people will read only a few lines to decide if they are interested. Do you best to get to the point as fast as you can, so people can see what the email will be about. It is often useful to put a summary of a few lines at the top and then explain your reasoning in more depth below, for people who want to learn more." We could point to a few good examples.
Cheers,
Matthew _______________________________________________ SciPy-Dev mailing list SciPy-Dev@python.org https://mail.python.org/mailman/listinfo/scipy-dev