change block doc to best practices

symfony-cmf / symfony-cmf-docs

The documentation for the symfony content management framework

http://cmf.symfony.com

44 stars 157 forks source link

change block doc to best practices #794

Closed dbu closed 7 years ago

dbu commented 7 years ago

i will follow up with further PRs for the other sections, but first want feedback on this one.

fixes part of #591

dbu commented 7 years ago

thanks, updated

dbu commented 7 years ago

i actually did it inconsistently on purpose, to distinguish between the block type and the service name. (i find the sonata block thing quite confusing and very complicated. so maybe i just got wrong what the type is supposed to do). but if you think its better this way, i am fine with it.