Document the system properly
Not just for end users, but also for developers. And keep this documentation up to date so we don't waste crazy amounts of time trying to figure stuff out based on out of date information
Prepare for Magento Certified Developer exam, Interview Questions and find the solutions to your queries at http://ka.lpe.sh This blog is dedicated to Magento developers with lots of resource.
Magento tutorial commented
Totally agree! You can find many good extensions and tutorials for Magento community here:
Please do a good documentation, with line by line explanation. I't takes long time but that is super cool for developer.
There is lots of tutorials but only few of them where you can read and do without additional googling
Alice Nguyen commented
If you find something useful for your Magento development, why don't you take a look at our Blog: http://www.magestore.com/blog/category/magento-tutorials/. I hope it could be the ideal place for our Developers and you to discuss. Welcome you!
Manish Prakash commented
magento development commented
it would be a great help to developers....
Affordable Magento Services: http://www.expertmagentodevelopers.com
We would surely love to contribute. A lot of developers would benefit from it specially for the starters.
For magento extension: http://goldenspiralstudios.com/
Chris Mousdale commented
I think this is one of Magento's biggest weaknesses. If you look at other open source CMS' or Frameworks, they have better documentation (MODX being a good example). With Magento a lot of the official documentation is out of date and, sometimes more up to date info from third parties can be incorrect or hacking core files.
I note this has been planned now (for over a year ^^) and whilst there have been some improvements recently (such as the Alan Storm articles), I would love to know on the official status of this 'task' from Magento viewpoint!
There are really some Parts outdated, like the SOAP API.
For Example the .NET API provides other function signatures and there are no docs available...
Community can *add* value to documentation but nothing will ever start before core development team start publishing first - API, file format documentation, developer references, source layout, design docs ...
Every project out there who has a great user contributed documentation started with it written by core developers or with developers closely talking to people in charge of writing it. Not to mention release cycles with feature/bug/whatever freezes so documentation authors can finish/update whatever is needed *before* new release is published with clear procedure in place how to document backward incompatibilities.
This task involves a few things; some of which I'm sure the community would be more than happy to contribute, and some of which require some of developers of Magento to lead the way in.
First off, Magento needs an 'Intro To Magento'. Essentially, we need a document which says, "Start here if you're thinking about making eCommerce sites with Magento". This already exists in a few places, but it would be great if there a was a site with a big sign saying "Start Here Guys!'"
Next up, we need an "Architecture Overview". I'm not talking about low-level documentation; we need YOU to tell US what the architecture of Magento is. This document would allow developers to get a 'feel' for how Magento is organised and how things work, before looking at any code.
Then, there's a general 'howto do thingy X' set of guides; these guides could be written by both Varien developers and us standard users, and let people looking for knowledge on how to do one exact thing get at the information without needing to understand the entire codebase.
Finally, the actual code itself needs to be thoroughly documented. This is where some of us more advanced developers can help you. In fact, whenever I'm developing a new extension or rootling through the code, I often finding myself updating documentation and leaving myself notes. This is one area that could be drastically improved by everyone, and lead to a more mature and stable codebase.
How could the community, write the doc on a system they didnt code, that the community dont know and about which, precisely, they ask doc for ?
I bought the 25$ magento user guide believing it would fill out some of the blanks but it was a total waste. I've been using magento for over a year and it didn't say anywhere that this was a beginner-from-scratch-never-seen-magento-before-product.
From day 1 of learning Magento, it takes about 3-4 months and then the official documentation is gone. From there, all you have is old forum posts, out-of-date wiki posts and occasionally brilliant but rare to be found bloggers.
You have my vote!
There is actually a lot of information available for developers but there is no structure and it is really a slow process of finding it.
I'd be interesting in contributing with what little I can offer.
We need manual for developers, its a MUST to do now.
Be sure i would contribute.
it will really help if we have document . because client want different feature and if we can understand system we can develop new modules very easily and it will increase popularity of magento.
I'd certainly contribute.
I certainly would. The comments that benz001 have made highlight the documentation difficult. If you could define a standard, format and method then I am sure there would be a lot of people willing to support documenting. The notice board approach we have at the moment means that information can become quickly incorrect or worse never read.