[docs] What BUGS me

[Sandro Tosi]

Hello Joshua,
we listen to and respect everyone's opinion, but your message is too
generic to "do something" to fix our documentation. We need more
detailed points to improve, even better it would be if you can provide
alternative wording for the part you don't like and so on.

I would like to point out that just saying "it's not clear" without
saying explicitly what's not clear won't help you (because we are not
able to help you) nor us (since we can't improve what we don't know).

Regards,
Sandro

On Tue, Jul 3, 2012 at 11:11 PM, Joshua Lawless
<joshualawless16 at yahoo.co.uk> wrote:
> Hi im Josh, I really want to learn your programming language but the
> tutorial just confuses me the more I know the more I realise I dont know. I
> feel that it doesnt explain everything clearly as if the person who wrote it
> had so much on his mind to put on the paper he skipped crucial parts which
> would make the whole thing make sense. I dont like giving greif or bad
> comments  or even constructive critisism especially when someone has gone
> out of their way to make something for a bunch of peope free of charge but
> to learn your language this I feel this really needs to be addressed so that
> everybody can earn your programming language. Please read this and hopefully
> even do something about it, it will benefit a whole bunch of people other
> than me to try learning your programming language, I know it sounds selfish
> it kind of is but wouldn't it benefit you more aswell if more people could
> use your programming language?
>
> thanks for reading this i hope it helps
>
> kind regards Josh
>
> _______________________________________________
> docs mailing list
> docs at python.org
> http://mail.python.org/mailman/listinfo/docs
>



-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi