Hi,
I am starting a new thread since the discussion in the thread "Starting
the 3.0 branch" is heavily leading in the wrong direction.
In the discussion I identified two contrary positions: On the one hand
people complain about the available documentation. On the other hand
other people tell them to improve the docs themself.
Lets get ready to rumble? I hope not!
I think both groups are both right and wrong.
Yes, the docs can be improved in many places. Some components are still
missing or the docs for a component is incomplete (if it comes to
explaining all options or how to use a component within the big picture
of a ZF2 application).
But, if you are missing anything and are not able to write the docs
yourself, at least you should create an issue and write down what is
missing. Create an issue for each component and state if examples are
missing or hard to understand, if options or features are missing, and
whatever you noticed. Create issues for missing tutorials how to do
stuff or explanations how to use a component within a ZF2 application.
Flood the issue tracker, please!
https://github.com/zendframework/zf2-documentation/issuesYes, the Zend Framework is an open source project and everybody is asked
to help out to improve the docs. But the bad vibes in the "Starting the
3.0 branch" complaining about the complainers (at least that is my
personal impression) won't solve the problem. Be thankful for anyone who
is getting up to write their concerns about the docs to the list.
Because for each person writing here, dozens won't write and just leave
to find a framework with a documentation that fit their needs better.
Don't underestimate the need for a proper documentation!
So, everybody who finds something missing in the docs or has suggestions
for tutorials to explain the big picture of a ZF2 application, please
create issues. And then lets do the DocHunt weekends regularly to
improve the ZF2 docs.
Then it will much easier to provide good ZF3 docs from the beginning. If
ZF3 should be a success the docs should be a major milestone to be
reached for.
Jm2c
Ralf