Request for better shader documentation

Hello, I am new to Cocos Creator, and I found it very easy to get started with.

However there is a major issue. Shaders are virtually missing from the documentation. I am posting this as a request for Cocos to have somebody on the team, a technical artist preferably, to write up the shaders documentation, with sample codes ← important.

The section on shaders is incomplete, therefore it’s unusable. This really breaks the engine for me because I believe games are 50%-70% shaders and UI. I am hoping a technical artist can be assigned the task of building a thorough shaders documentations. Specifically CCEffect, not GLSL, I can read about that on my own. I still appreciate a lot of example code, and it would be good to include. The marcos and tables are given, but it is still difficult to understand all of those without examples and use case.

But actually a lot, if not most of the relevant documentation is unwritten, such as converting from position to clip, what a_color0 is, a lot of attributes are not covered, neither are cc uniform and methods. No section on stencilling and masks, how to use postfx shaders, how do to blending, which it seems is done purely with marcos but should be possible to do with numbers too, and how to do depth sampling … and other shader stuff. w/o these essentials, this makes it truly impossible for us to use this engine.