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.

It appears FOSRestBundle seems to be the main point of the article, and adding support for the LINK and UNLINK HTTP verbs is also interesting.

There's also the allusion to custom content-types and versioning schemes and a small bit about using the SF2 web client and crawler for (unit) testing.