Hello Marc,
> I know your feelings, I feel the same way sometimes. I´m looking at the docu > and the thing I want to look up is not described in detail. Now I have > only two options, go ask here or in IRC. It is enough for me, because > I see that in the channels and here are enough people to help me. > The great but is, not everyone is fond of that kind of approach. The problem with asking questions on IRC is a) RTFM and b) that every answer given there is lost, as it likely doesn't go into the documentation, where it should have been in the first place, and when not there, go there as quickly as possible, I believe. > The example I gave a few times are my coworkers. The have family, > they make sports, they just want to get it work. Their approach > is a different kind, they look in the docu, at the most they > will do a short google search. After that, the product is simply not good! > The acceptance of ZF1 in my company is <0, except of me and I battled > hard that I can use it in my projects. I really liked ZF1, even with it flaws. Still, I believe that ZF2 solves the problems that couldn't be solved with ZF1, but creates a bunch of new ones . . . > The docu of ZF2 is even worse… . . . exactly! > What I see in the channels is that there is some kind of rest period. > There are a few who make the modules site, but in the whole it seems > really quiet. Ok, the last weeks were hard, but there has to be some kind of > focus to the documentation in the near future. I strongly agree! Sure, there is quite a number of contributors and early adopters, and these will be more interested in fixing bugs and providing more features - since they already know what some (most?) of us don't. I guess they can't be bothered with providing bits of documentation for stuff they already know. It's like some kind of project blindness, I assume. > I know that it is on github, but saying that I can change the whole thing by > just doing some PRs is not helping. I have to understand the whole thing > before I can make PRs, I have to learn. Most people just can not do that in > addition to their normal job. It is not their job to do it, too. Exactly, how shall I write the documentation for stuff I haven't understood yet? Those that have understood could greatly contribute. I wish they would. Best regards, Andreas -- List: [email protected] Info: http://framework.zend.com/archives Unsubscribe: [email protected]
