I'm sorry if you missed the big picture. The aim of this article was to show how to quickly build decent APIs using the Symfony2 framework. As far as I know, there was nothing documented yet.
"The right way" mainly means using the right tools and following best practices.