Let me start off by saying that Magento is an absolutely incredible application. Having looked at the code over the last few days, I can say that the team at Varien is more skilled than almost any other programming company that I’ve had the pleasure (or displeasure) of dealing with.
Saying that, I must say that at this point at time, Magento is severely crippled in regards to developer use. The code base is huge and the conventions which comprise Magento’s framework are pretty much unprecedented. I have been a programmer for 15 years and never have I had such a hard time understanding the mechanics of an application.
I’ve even purchased the PHP|Architects book, read it cover to cover, and still can’t say that I have a true grasp of how Magento works or the course I’d need to take if I wanted to delve further into the code.
Fact of the matter is that this book is not enough, the Wiki is not enough, and Magento “documentation” in general is not enough. I applaud Varien on creating a first-rate eCommerce application, and I understand it has only recently been released, but something needs to be done about documentation.
Can someone from Varien respond and let me (and the community) know if there is anything in the works regarding documentation?