Agreed for the most part. However, all of the things you mention are difficult to get right. It would take a good deal of the team’s time to improve the writing quality I presume. If so, the question becomes one of priorities. Is it worth spending that time or using that time on something else? My impression is that it’s probably worth spending a week or so on it and then iterating periodically for a few months afterwards in response to feedback.
Be more concise
I think you can actually be both concise and lengthy. Have a “here’s the quick version” section and then a “if you want more detail, here’s the details” part that follows. Or maybe break it into two separate posts.
Thanks for pointing me to this. I never saw it before and think it’s so cool!
Here’s how you can audition for a spot in our prestigious club
I don’t get that impression.
Re: the section “How to get started”: There must be some way for new users to actively participate that does not require hours or days of prep work.
I don’t agree with that. Large requirements will definitely filter more people out, but it’s not clear that that’s a bad thing. Personally my sense is that it’s a good thing on balance.
Explain the karma system
This doesn’t seem important enough to spend time on in this post. It seems more appropriate to have those questions addressed in the FAQs and perhaps have the post mention the FAQs as something to refer to.
Agreed for the most part. However, all of the things you mention are difficult to get right. It would take a good deal of the team’s time to improve the writing quality I presume. If so, the question becomes one of priorities. Is it worth spending that time or using that time on something else? My impression is that it’s probably worth spending a week or so on it and then iterating periodically for a few months afterwards in response to feedback.
I think you can actually be both concise and lengthy. Have a “here’s the quick version” section and then a “if you want more detail, here’s the details” part that follows. Or maybe break it into two separate posts.
Thanks for pointing me to this. I never saw it before and think it’s so cool!
I don’t get that impression.
I don’t agree with that. Large requirements will definitely filter more people out, but it’s not clear that that’s a bad thing. Personally my sense is that it’s a good thing on balance.
This doesn’t seem important enough to spend time on in this post. It seems more appropriate to have those questions addressed in the FAQs and perhaps have the post mention the FAQs as something to refer to.