Few months back, I explicitly asked question from walzer whether Cocos Future is planned for well skilled/core developer or allow everyone to make games(obviously more skilled, more use of features!). Also, I am not talking about "no programming needed" game engine like BuildBox!!
So, walzer told that, the aim is that it's easy for every one to make games!
You said, you look at api to figure out things! It's because you're pretty skilled programmer with expertise not just in programming language C++ but also in design patterns, openGL, etc!! Even I try to see apis. But I'm only decently skilled with C++ to write decent code for cocos2d-x.. I'm not skilled to modify/understand enough openGL and others things or high level complexity of C++.
(Hence, I never demanded from community to teach me how can I customise the some/entire engine. I just expect whatever is available, I can use that. And you also know, more than enough is already there in cocos2d-x to make top quality games)
This is how cocos2d-x API documentation is done!Hilarious it is???
As if a person doesn't know the meaning of
, that it's explicitly written "Query the left sprite's cap inset". Lot of part of api guide is done like this.
There are lot many instances in MOST FREQUENTLY USED PARTS IN GAMES like ScrollView, ListView. There api documentation is done exactly like I showed in pics above. Do you expect me to dive deep in the code to figure out what those functions are or else forget to use the awesome api? If I would be so expert, I would be creating engine myself..
Till Date, I've not good idea how can I effectively to use 9-slice sprite!! So, basically 90% of this api is WASTE for me. Similarly for other apis as well. 50-90% of those apis is waste for me because average cocos2d-x user(average game developer) CANNOT understand it.
Basically 50-60% of the great cocos2d-x engine is WASTE for me because I will never understand how to use it because I came here to create games and not the engine itself!
(Don't get me wrong. I've you putting effort in writing Programmer's guide and clearly see the ability of this engine which is why I'm sticking to it since March 2014)
I also check Cocos2d-x cpp tests which is my handy guide! And it itself is not written "practically" at some portions!
For example, I wanted to see how the height can be dynamically set for a scroll view. I checked everywhere! No single info. Ultimately, I had to put a hack which was to put in element from last to first instead of natural order.
It's not that some people don't put effort.
Simple question is!! Why has the code-writer of such awesome apis decided to write function description in a way that only he or Level 10 developers can understand!! Why do you want me to dig the code to figure out what is the api all about and that too lot of times??
My background is, web developer with 1yr experience and I want to use C++ for obvious reasons with Cocos2d-x. I've full time job, use my free time to make games.. I am single member indie developer. I want to create professional quality games, not just to please myself or feel good about it!!
Where do you think, it's "weird" to expect guide for most frequently used features in a game?
It'll save my time. I can focus on my creativity. And if I would be able to finish the game in time. I could even take out time to help community by giving back some example tutorial!! But the fact is that, I spent "2 days" to get my ScrollView working as expected(with that hack!) because I wanted to set the height dynamically depending upon elements whose height are calculated based on the various sprites!!
I hope, it still won't feel weird to you that why do people need programmer's guide!
Today, I saw LinkedIn course list for skill development in Game making...
Do, you know how many were in Cocos2d-x?? I was disappointed because such a great engine got such low popularity.
And Unity? From 163 courses atleast 60-70% tutorials on various topics!!
Because people creating tutorials know that all kind of developers can use Unity and their reach is much wider!
I'm sorry for such long message. But it was all to justify why you should not feel "weird" about why developers need it. Cocos2d-x is in itself is a great engine. I've already made games in past with Unity, Corona, and seen apis of few other engines. But crucial part is missing-ladder.
And this is the reason why ALL resources(video tutorials, books) in market are covering BASIC topics except 3 books.. Because they themselves don't know cocos2d-x enough or they can't spend their hard-spent time for others!! Had they learnt the engine easily, they would have been more willing.. Few people, like MakeSchool, Sonar, tutorial writers started from making basic tutorials and they stopped!