[SciPy-Dev] establishing a Code of Conduct for SciPy
Ilhan Polat
ilhanpolat at gmail.com
Tue Oct 3 11:17:12 EDT 2017
I should have probably put a smiley in the end. I mean it quite lightly by
the way.
On Tue, Oct 3, 2017 at 5:16 PM, Ilhan Polat <ilhanpolat at gmail.com> wrote:
> Ah come on. What is this condescending nonsense "A score of around 10-12
> is roughly the reading level on completion of high school. Text to be read
> by the general public should aim for a grade level of around 8."?
>
> On Tue, Oct 3, 2017 at 2:45 PM, Matthew Brett <matthew.brett at gmail.com>
> wrote:
>
>> Hi,
>>
>> On Tue, Oct 3, 2017 at 1:07 PM, Ilhan Polat <ilhanpolat at gmail.com> wrote:
>> > While I agree with Bennet and Matthew, I think the item should sound as
>> much
>> > as its importance. If it starts to sound like a Terms and Conditions
>> text it
>> > would defeat the purpose in my opinion. I would go along the lines of
>> >
>> > Help your audience by keeping the discussion focused. Your email will be
>> > read by hundreds of people on different media (including search engine
>> > hits). Many can only afford to skim through the mails to decide whether
>> the
>> > subject is related to their expertise. Placing a brief summary is a good
>> > practice if the content does not allow for shortening. On the other
>> hand,
>> > this should not be taken as a basis for terseness. "Things should be as
>> > simple as possible but not simpler."
>> >
>> > By the way, I think the numbering is off at item 3.
>>
>> Terms and Conditions is rather in the eye of beholder though.
>>
>> Just for example, if you run these last 3 versions though readable.io
>> you get grade level reading scores (lower = easier to read) of:
>>
>> Me: 4.4
>> Bennet: 6.6
>> Ilhan: 9.2
>>
>> I highly recommend readable.io - I didn't run it on my stuff until
>> just now, but I generally find it gives useful suggestions on
>> improving clarity and readability.
>>
>> Cheers,
>>
>> Matthew
>> _______________________________________________
>> SciPy-Dev mailing list
>> SciPy-Dev at python.org
>> https://mail.python.org/mailman/listinfo/scipy-dev
>>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scipy-dev/attachments/20171003/525060f7/attachment.html>
More information about the SciPy-Dev
mailing list