Feedback on technical documentations first version

[LauriM]

Considerations that should be taken before executing the plan/moving forward with the design.

Platforms

Lots of different platforms, hard to support. Main issues are going to be platforms that are highly different from each other (consoles / mobiles)

This is mainly going to affect the rendering wrapper. (Mobiles usually run old versions of OpenGL, while consoles run only modern types of API's)

Premake4

While premake works nicely, its going to be hard to target to all the platforms listed using it. For example, generating Tegra projects for VS is going to be a pain in the ass.

I would personally recommend a hybrid model for the project configurations, use VS target all platforms that are possible.

• Windows
• Android
• WinPhone
• PS4
• XBone

Then use premake to target to the rest of the platforms that are not supported by VS.

Threading

Threading is something that should be planned before starting the work on other systems, this is mainly because it is going to cause some limitations on how the data should be used. For example, profiler has to be designed to run on multithreaded environment to get any good data out of it.

Also, what way is the threading done? Old style "thread for each major subsystem" or more modern "workers with tasks"?

Its good to note that platforms like HTML5 do not support threads, so there should be a way to fall back to singlethreaded design if the platforms is going to be supported.

Graphics wrapping

After the final platforms have been locked, this is one of the most critical parts where the development can fail badly.

Overall

Overall the documentation is heading to a right direction