URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/basic_concepts/scene.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/installation/Windows.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/editors_and_tools/cocosCLTool.md

上面的几个例子，项目都是使用的 Cocos2d-x 的源码，编译的时候会将源码也编译，可能花费较长时间。为获得更快的编译速度，可以使用预编译库。使用时需要在创建项目的时候增加参数 -t binary。示例：

cocos new MyGame -p com.MyCompany.MyGame -l cpp -d ~/MyCompany -t binary

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/editors_and_tools/creator_to_cocos2dx.md

local creatorReader = cc.CreatorReader:createWithFilename('creator/CreatorSprites.ccreator')
📝 https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/editors_and_tools/creator_to_cocos2dx.md#L167

the CreatorReader seems to be in creator module rather than cc

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/ui_components/buttons.md
error: ‘Button’ has not been declared
error: ‘Widget’ has not been declared
error: expected ‘,’ or ‘...’ before ‘type

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/installation/Linux.md

Link Cocos Command-line tool does not work.
404 error.

@slackmoehrle You need another new rule. :D

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/sprites/polygon.md

能不能有一个js的示例？现在只有C++的

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/about/why.md

On mobile display. Next button (to navigate next page) is under feedback button.

Pressed next button Luckily but difficulty

Thank you

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/index.md

环境搭建

• Android - Android Studio

• Win32 - Visual Studio

• Android - Visual Studio Don't Support

• macOS 平台

• iOS 平台

• Linux 平台

• Android - Eclipse `` Deprecated

• Android - Command-line

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/scripting/script_component.md

Just learning Cocs2d-JS so this may be covered elsewhere, but this doesn't tell me where to get the Cocos engine files (maybe CCBoot.js? jsb.js? not sure) and how to include them in my Javascript file (import statement? script tag?)

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/advanced_topics/sqlite.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/installation/Android-terminal.md

This command "brew install android-sdk android-ndk" is no available.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/installation/Linux.md

cocos2d/cocos2d-x#18488
I'm not sure where the user got this. Linux seems like the most relevant page.

@slackmoehrle Can you confirm this? How about close or transfer that issue?

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/ui_components/index.md

It is too difficult to find the function of one such as button,sprite and so on. This api docs is useless. Though lua is easy, but I can't find the right way to use it in cocos. I'm sad.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/advanced_topics/shaders.md

- `Material` can have one or more `Technique` objects
- each `Technique` can have one more `Pass` objects
- each `Pass` object has:
  - a `RenderState` object,
  - a `Shader` object including the uniforms

As an example, this is how a material file looks like:

{% codetabs name="JavaScript", type="js" -%}
// A "Material" file can contain one or more materials

The code block is a "Material" file content, but it is marked "JavaScript" codetabs, is it a mistake? @slackmoehrle

English Discuss: http://discuss.cocos2d-x.org/t/effekseer-particle-effect-editor-for-cocos2d-x/39772

中文讨论：http://forum.cocos.com/t/pu/58149

GitHub: https://github.com/effekseer/EffekseerForCocos2d-x

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/editors_and_tools/prebuilt_libraries.md

I can’t find any useful information of how to work with prebuilt libraries. Not step by step guide.
How can I setup a new project for android with prebuilt libs?
Also, for iOS it's simple, but anyway there should be a guide for any platform.

Moreover, prebuilt libraries should be n1 "feature" while using cocos2d-x.
It saves time considerably and easy to use one cocos2d-x lib for many games.
Also, if source code needed - it's so simple easy to add it into Xcode just by drag and drop cocos2d-x project file(with proper settings before). Well, for me actually, during 1.5 year of development of 1 game - I never needed source code, like for debugging.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/installation/index.md

Python 2.7.5+ not only Python 2.7.5.

In case win32 project, you need Visual C++ Redistributable for Visual Studio 2012 x86 and Visual C++ Redistributable for Visual Studio 2010 x86.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/basic_concepts/index.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/basic_concepts/director.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/event_dispatcher/mouse.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/index.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/basic_concepts/index.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/editors_and_tools/cocosCLTool.md
希望官方 大大 ,尽量把文档往详细的方向写。好多官方提供的接口，在官网文档上找不到介绍。新手逛论坛和社区也只能得到一些零碎的信息。

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/sprites/manipulation.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/actions/index.md

Since the next button link to http://cocos2d-x.org/docs/en/actions/, nothing happens when you click on it.
Expected - go to the next article.
Actual - nothing happens.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/installation/index.md

Typo in the doc. Repeated "be installed" in the following text.
Cocos2d-x can be installed be installed on OS X, Windows ...

warning fixed at cocos2d/cocos2d-x#18908

related discuss at https://stackoverflow.com/questions/22745076/libpng-warning-iccp-known-incorrect-srgb-profile/

explain it, and tell our user how to solve this issue

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/editors_and_tools/cocosCLTool.md

In the above examples, a new project is created using the Cocos2d-x source code. If you want to create a new project using the pre-built libraries you need to pass an additional flag of -t binary. Example:
cocos new MyGame -p com.MyCompany.MyGame -l cpp -d ~/MyCompany -t binary

the command above error, see:

▶ cocos new MyGame -p com.MyCompany.MyGame -l cpp -d ~/MyCompany -t binary

Python 2.7.10
Template named 'binary' is not found.
Multiple templates detected!
You can select one via -t arguments.
Or choose one now:

1 default
Select one (input number and press enter):

I suggest this paragraph was removed @slackmoehrle

When user reads English docs the getting_started page of every chapter.

such as, click "中文" Button on http://cocos2d-x.org/docs/en/basic_concepts/getting_started.html

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/physics/collisions.md

It's very difficult to implement the joints without a demo. so there should a demo code for every joints

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/audio/index.md

mp3, mid, oggg, wav
📝 https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/audio/index.md#L11

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/installation/Windows.md

错误提示为访问冲突

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/index.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/audio/engines.md

Nothing is here.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/ui_components/buttons.md

how could I call a api with lua? It is all the c++ function.

For the creator_to_cocos2d-x docs,

http://docs.cocos.com/cocos2d-x/manual/en/editors_and_tools/creator_to_cocos2dx.html
http://www.cocos2d-x.org/docs/cocos2d-x/en/editors_and_tools/creator_to_cocos2dx.html

One existed manual, another not, so that one link links one doc in both website always be failed.

Creator docs use this type link :
[](../../../../cocos2d-x/manual/zh/editors_and_tools/creator_to_cocos2dx.html)

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/other_node_types/parallax.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/installation/Android-Studio.md

proj.android-studio folder is missing. I used to use it in my android studio last year (maybe with 3.16 version). It no longer exists in 3.17 version. Please enlighten this ASAP. Is android studio no longer supported?

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/actions/getting_started.md

Comments
// MoveBy - lets move the sprite by 500 on the x axis over 2 seconds
// MoveBy is relative - since x = 200 + 200 move = x is now 400 after the move

Isn't it should be 200 + 500 = 700?

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/basic_concepts/parent_child.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/event_dispatcher/priority.md

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/installation/Android-terminal.md

In the left menu, click on Installations, then Android, then frustrating, since the first thing you see is that the document is deprecated. It looks like that Android support is deprecated itself.
Expected - a user should see http://cocos2d-x.org/docs/en/installation/Android-Studio.html page first.

Android development is a complicated beast.

It does not add enthusiasm as well.

https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/physics/concepts.md
has this content:

###Material
Materials describe material attributes：

-density：It is used to compute the mass properties of the parent body.

-friction：It is used to make objects slide along each other realistically.

-restitution：It is used to make objects bounce. The restitution value is
usually set to be between 0 and 1. 0 means no bouncing while 1 means perfect
bouncing.

That should be:

Material

Materials describe material attributes：

• density：It is used to compute the mass properties of the parent body.
• friction：It is used to make objects slide along each other realistically.
• restitution：It is used to make objects bounce. The restitution value is
  usually set to be between 0 and 1. 0 means no bouncing while 1 means perfect
  bouncing.

more than one place has the same issue, it should be check when free time

Cocos2d-x Documentation

Getting Started

Basic Cocos2d-x Concepts

Sprites

Actions

Building and Transitioning Scenes

UI Components

Other Node Types

Event Dispatcher

3D

Scripting

Physics

Audio

Advanced Topics

VR (virtual reality)

Installations

Tools

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/event_dispatcher/custom.md

在写自定义事件的时候，遇到了一个问题。文档中添加listener时使用的是：addEventListenerWithFixedPriority，而新手想要的通常是：addEventListenerWithSceneGraphPriority，因为Node销毁后，如果用前者，可能导致在事件处理函数中调用Node的方法时，出现Node不合法的问题。表述不清楚，见谅。

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/en/about/why.md

Viewing the bottom of this page from smartphone, the "Feedback" button is put on the "next" (>) button. That makes to touch the next button difficult.

URL : https://github.com/cocos2d/cocos2d-x-docs/blob/master/zh/index.md

I would like to improve our release notes that we send out to developers. UnReal does an amazing job, example: https://www.unrealengine.com/en-US/blog/unreal-engine-4-17-released

What do you think about improving the quality of the release notes with more graphics and videos? (if the features make sense for these extras).