fodev.net

General => Community Feedback => Topic started by: remake on April 15, 2019, 12:29:52 pm

Title: Wiki - usefull docs and articles for FOnline and FOClassic.
Post by: remake on April 15, 2019, 12:29:52 pm
Hello!

I have an idea to create a wiki with articles for (upcoming) developers. We can put there not only the references for functions or classes with their methods like it is in docs but also the descriptions for tools, files and their formats, explanations of the code, tutorials and "howto" articles, about tools which can help to run own FOnline game.

It can be a place to gather and share with own experience, solutions or even learning from the basics (or "zero") to dev.

I have many technical information to share or describe but I don't want to work with this idea alone.

My question is: Who wants to join?
Title: Re: Wiki - usefull docs and articles for FOnline and FOClassic.
Post by: adumbperson on April 15, 2019, 07:38:46 pm
I sure know what people don't want...

A wiki that gonna vanish after sometime...

I believe that wiki tech isn't really suitable for documenting devel...

Instead I've an idea which I think is more user friendly for every people developing...

Why not documenting stuff through a man-page like software...

Would be easier and safer for every parties to work that way.

Title: Re: Wiki - usefull docs and articles for FOnline and FOClassic.
Post by: Koniko on May 06, 2019, 11:20:18 pm
Yeah, Man-page is a tool of gods. It can pipe text easily and let you deep search it seems like a good idea but questions are who will spend his free time in making such a mad idea come true and keep it alive? I highly doubt that more than maybe few people would be intrested in usage of such manual not to mention nobody even wants to work with FOnline as of lately when you've got absolutely limitless possibilties outside of belarussian madness.
Title: Re: Wiki - usefull docs and articles for FOnline and FOClassic.
Post by: adumbperson on May 07, 2019, 08:13:33 am
I can tell people what brought me on the right way with the original FOnline SDK (MANY YEARS AGO).

I was and I still very desirous to succeed with it...

So it made me look very deep to gather all resources that I could to be successful... documentation was one of these...

While discovering vault112 from wladimiiir I've found a chm file into the project https://github.com/wladimiiir/vault112/tree/master/Docs/output (https://github.com/wladimiiir/vault112/tree/master/Docs/output), by using some chm tools I've been able to convert to html...(I wasn't able to use doxygen tool at this moment...)

Since, I've found a way to make doxygen to work...
It is very useful and easy to use(when it works...).
To add/delete things just edit files
Code: [Select]
./src/{reference,manual}/* and then fire up BuildEn.cmd
Appreciate console output.
Now go to
Code: [Select]
./output/en/html... enjoy

Here full build environment:
http://dl.free.fr/jiqAg2iP1 (http://dl.free.fr/jiqAg2iP1)

You also need to take in consideration angelscript's documentation for syntactic sugars and features...

You also need a good introduction to C programming and object pattern understanding.


note that without prog skill documentation is useless...
Title: Re: Wiki - usefull docs and articles for FOnline and FOClassic.
Post by: remake on May 23, 2020, 10:06:08 pm
Prepared in https://docs.fonline.info/