If you are completely new to Avalon, the Framework subproject is not the easiest place to start. We suggest you take a look at the Avalon Phoenix getting started document first, as it will take you through downloading, installing and then running something (a very simple server program) much more concrete.

Probably the next smart step is to learn by example. Take a look at one or two of the applications that use avalon and at how well these are set up, and at some of the available components (in Excalibur) and services (in Cornerstone) Avalon offers.

You will find that the Framework has an important role in each and every one of these. To learn what that role is and how it fulfills this role, you should read our guide, which starts with a summary of OOP best practices.

When you get stuck in sources, documentation, and the mailing list archive, post your questions to the mailing list (information on it is here). For many, Avalon poses a steep learning curve, and we'll try and help you flatten it as much as we can.