Is there a better way to learn a new language - or a framework - than by looking at showcase apps? Lots of symfony users got it started by following the 2005 advent calendar, or by copying the code used in askeet to do similar things.

Just like us, you probably don't want to spend hours reading the manual. You prefer to find a code snippet that does something close to what you need, copy it, have it run, and then customize it for your own requirements. You try to understand only what must be adapted, to keep your mind clear and focused on your primary task.

That's why we thought that, in addition to the current documentation (book, API, wiki), the symfony website needed a repository for code snippets - that is to say a place where anybody can post small code chunks, tag them for easy search, and rate others. In a web 2.0 world, this application also needs AJAX interactions and dynamic visual effects.

From that reflection, the idea of the next symfony showcase app struck us. This very code snippet repository would be the perfect candidate. It would contain parts of its own code (isn't it cool to be both object and subject?), reducing the need for a tutorial to learn it. In addition, the version running on the symfony project website would be the best possible demo.

That's why this post is a double announcement.

First, we are proud to announce the new code snippets section of the symfony website. Use it when you don't want to look for an explanation in the book, but just a quick solution to a problem that others may already have met. And also use it to share your solutions to common problems - a bit like what the HowTo section of the wiki did, but in a more structured way.

The second announcement concerns the release of the Snipeet application, a new open-source project with its own website, SVN repository and bug tracking system, built with symfony. Install it if you need a code repository in your website, it is free of charge, and released under the MIT license. Browse its code if you look for good solutions to common problems.

And since this showcase app is a great tutorial about agile development, web 2.0 applications and symfony in general, it is a must see for anybody learning the framework. Dive in right away!

Published in