Latest Posts

Topic: Documentation rework

kaputtnik
Avatar
Topic Opener
Joined: 2013-02-18, 20:48
Posts: 2433
OS: Archlinux
Version: current master
Ranking
One Elder of Players
Location: Germany
Posted at: 2018-05-17, 18:22

The current documentation is made with an old django-app called django-sphinx. This application isn't maintained anymore and makes it impossible to update Django itself in the future. To get rid of this application there is an attempt to build the documentation directly as html files and serve those.

You can find a test setup at http://alpha.widelands.org/documentation/

Any remarks or suggestions?


Fight simulator for Widelands:
https://wide-fighter.netlify.app/

Top Quote
ypopezios
Avatar
Joined: 2018-04-20, 00:22
Posts: 220
Ranking
Widelands-Forum-Junkie
Posted at: 2018-05-17, 18:33

Why not use the wiki instead?


Top Quote
kaputtnik
Avatar
Topic Opener
Joined: 2013-02-18, 20:48
Posts: 2433
OS: Archlinux
Version: current master
Ranking
One Elder of Players
Location: Germany
Posted at: 2018-05-17, 20:20

Sidenote: If we talk about 'documentation', the currently documentation is mainly about LUA scripting. So it is useful for people who wants to create an own scenario.

ypopezios wrote:

Why not use the wiki instead?

Using the Wiki would cause additional work. The source code documentation is best done in the source code itself. So a new developer can read it directly when he wants to edit the code. If a developer should do the documentation in two places (source code and Wiki), it causes additional work wich is error-prone and time consuming.


Fight simulator for Widelands:
https://wide-fighter.netlify.app/

Top Quote
einstein13
Avatar
Joined: 2013-07-29, 00:01
Posts: 1118
Ranking
One Elder of Players
Location: Poland
Posted at: 2018-05-17, 21:03

Ohh... You mean documentation = part of our site that is generated out of Widelands code itself?

I don't know almost anything about that, so I will not say anything against what you develop. You are my hero here! face-smile.png


einstein13
calculations & maps packages: http://wuatek.no-ip.org/~rak/widelands/
backup website files: http://kartezjusz.ddns.net/upload/widelands/

Top Quote
GunChleoc
Avatar
Joined: 2013-10-07, 15:56
Posts: 3324
Ranking
One Elder of Players
Location: RenderedRect
Posted at: 2018-05-22, 08:25

Looking good face-smile.png

Just 1 nit: I find the menu text hard to read in the left sidebar - use black text? Or the same style as on the top.

There is one more reason not to use the wiki for this: When changing the code, a developer will see that there is some documentation that goes with it. If it's in the wiki, developers will forget to update the documentation when making changes, because it's out of sight. We would end up with horribly outdated documentation.


Busy indexing nil values

Top Quote
kaputtnik
Avatar
Topic Opener
Joined: 2013-02-18, 20:48
Posts: 2433
OS: Archlinux
Version: current master
Ranking
One Elder of Players
Location: Germany
Posted at: 2018-05-23, 08:42

GunChleoc wrote:

Just 1 nit: I find the menu text hard to read in the left sidebar - use black text? Or the same style as on the top.

I will give the text a real dark green then. If this isn't satisfying, we can change it also later.

May i find time this evening to get the new documentation on the productive site.


Fight simulator for Widelands:
https://wide-fighter.netlify.app/

Top Quote
kaputtnik
Avatar
Topic Opener
Joined: 2013-02-18, 20:48
Posts: 2433
OS: Archlinux
Version: current master
Ranking
One Elder of Players
Location: Germany
Posted at: 2018-05-27, 11:42

The new documenation is online now. It may take a short time to load the css the first time you call it.

Hopefully you like it face-smile.png


Fight simulator for Widelands:
https://wide-fighter.netlify.app/

Top Quote
GunChleoc
Avatar
Joined: 2013-10-07, 15:56
Posts: 3324
Ranking
One Elder of Players
Location: RenderedRect
Posted at: 2018-05-30, 15:11

Thanks!


Busy indexing nil values

Top Quote
Nordfriese
Avatar
Joined: 2017-01-17, 18:07
Posts: 1929
OS: Debian Testing
Version: Latest master
Ranking
One Elder of Players
Location: 0x55555d3a34c0
Posted at: 2020-01-14, 17:36

Is the lua documentation still being updated? It´s getting fairly outdated, e.g. https://www.widelands.org/documentation/autogen_wl_map/#economy refers to no longer existing functions and misses some new functions


Top Quote
kaputtnik
Avatar
Topic Opener
Joined: 2013-02-18, 20:48
Posts: 2433
OS: Archlinux
Version: current master
Ranking
One Elder of Players
Location: Germany
Posted at: 2020-01-14, 18:18

The line ate the bottom states: Last updated on Jan 14, 2020

The documentation is made of the master branch, as far i remember. The master branch should be updated regularly and if an update fails some admins should get an email. Didn't looked if the master branch is up to date on server though.

When did the changes you mentioned got into master?


Fight simulator for Widelands:
https://wide-fighter.netlify.app/

Top Quote