flareteam / flare-engine

Free/Libre Action Roleplaying Engine (engine only)
http://flarerpg.org/
GNU General Public License v3.0
1.11k stars 188 forks source link

Textbook of Flare is needed. #1558

Open sujiniku opened 6 years ago

sujiniku commented 6 years ago

I think that it is better tat there are the documents like about Flare textbooks.

It is not a INI programming textbook with using Flare, but a textbook to the reader able to coding Flare-engine self with C++ program.

For example,at IT companies, writing jobs is required not only for writing code but also for making collaborators and successors easier to understand the code.

Therefore Flare community needs the documents that explain basic programs of flare-engine and documents explaining the history of the Flare community.

But this job is not needed immediately for Flare community. I think that this educational response can be done even after v1.0 is released.

In order to the readers can leran various information systematically without reading GitHub's Flare logs, we should teach.

Also, many C++ programmers do not know about SDL, and many people do not even know about GNU tools such as GetText etc.. Flare Community should explain how SDL is called in Flare. Flare Community should explain In where is Flare's calling SDL file.

If possible, It is better that we explain what exteranal tools such as GerText used in Flare have, what file in Flare are calling, what kind of processing is done in code, and so on.

sujiniku commented 6 years ago

If Flare aims at a game engine for many game writers, we need documentation that explains how to use variables, branching / loop processing, local variables, global variables, encapsulation of processing, etc in Flare.