ach wrote
1... because I am not a native speaker, though ...
2... "create rich documentation repositories" sounds too techy.
3... too long and complicated for an introduction ...
4... Why list "individuals, teams and companies"? Couldn't just "users" be enough? The original "It is targeted at developer teams, workgroups and small companies." is better, because they are the actual "target groups".
5... "to create and collaborate": create what? Isn't there an object needed?
6... It is just a feeling ...
1. I find many non-native English speakers do a better job than those born with it :) - but agreed, it needs to be readable without 90% reaching for their dictionary.
2. Who is the introduction for? I'm guessing it's going to be of interest to those who are technically competent / curious. End users (i.e. those who just add / edit content) will be more interested in the syntax page (which I feel needs to be re-worked, having recently read it as a new user)
3. I agree - which is why I used bullets initially, and would still choose that if I were king. ;) I think visitors to the site should take priority over those who copy and paste the introduction for use in reviews, etc. - but I understand andi's reasoning
4. Just "users" does not convey the ACL component, whereas "individuals, teams and companies" implies there is user / group access control. I changed the original because I see no difference between "developer teams" and "workgroups".
5. No, the previous sentence makes it clear we're talking about documentation.
6. Nothing wrong with that as an argument. :)