I think there is one more thing the community can do to help improving the 
documentation: I see a lot of blog posts about Symfony. In a sense that's 
great - it means that Symfony draws a lot of interest and we can only be 
happy with that. However I would love to see the articles cross posted to 
the Symfony documentation repository[1].

What would be the advantages of cross posting:

- The articles could be enhanced by the community,
- The articles could be updated by the community when some updates are 
required because of an API change in Symfony - I see very little posts 
being updated and this results in outdated info,
- The documentation would be centralized in a single place and indexed.

So why don't people already cross post ? 

- May be because we only have a "cookbook" and a "book" sections, we might 
add a "technical articles" for the articles that do not fit in the 2 former 
sections,
- May be because people fell they don't get enough incentive (ie credits) 
when doing so. Fabien, Ryan, what about adding a contributors section to 
the documentation (and to the downloadable PDF) ? I think we should also 
include commits to the documentation repository on the Sf2 contributors 
page[2] - to me, the documentation and the code are equally important when 
it come to build an awesome community.

Fabien, Ryan and the blog authors, what do you think ?

Cheers,
Victor

*(XPosted on http://symfony.com/blog/new-in-symfony-2-2-more-documentation)*

[1] https://github.com/symfony/symfony-docs
[2] http://symfony.com/contributors

-- 
-- 
If you want to report a vulnerability issue on Symfony, please read the 
procedure on http://symfony.com/security

You received this message because you are subscribed to the Google
Groups "symfony developers" group.
To post to this group, send email to symfony-devs@googlegroups.com
To unsubscribe from this group, send email to
symfony-devs+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/symfony-devs?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"Symfony developers" group.
To unsubscribe from this group, send email to 
symfony-devs+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to