WIP wiki cleanup and update

[vultraz]

I recently took it upon myself to begin cleaning up the wiki of all the old, outdated pages and updating and revamping the remaining ones in order to provide clearer documentation to users. Many of them had not been updated since version 1.4 or earlier! So far I have updated the primary pages related to content creation and distribution, and will soon move on to the rest of those listed under Create.

The following pages have been updated or added:

• Editing Wesnoth
• Add-on Structure
• Building Maps
• Building Scenarios
• Building Campaigns
• Multiplayer Content
• Custom Units
• Distributing Content

There's still a long way to go, however. I would appreciate it if you, the wiki users, could point out any outdated pages, content, inaccuracies (especially in the pages I've updated), typos, or even spam you notice on the wiki. Simply leave the link and I'll take a look.

Thank you.

[gfgtdf]

i just read the page you linked in your post: MultiplayerContent

and there is says the the following code would casue OOS:

Code: Select all

'[event]
   name = turn 3
   [message]
     side_for=2
     message= _ "Play the casino!"
     [option]
       message="Yes, I'll bet 100 gold."
       [command]
         {RANDOM 0..200}
         {MY_ADJUST_SIDE_GOLD_MACRO 2 $random}
       [/command]
     [/option]
     [option]
       message= _ "Not interested."
     [/option]
   [/message]
[/event]

have you tested that this cause OOS?
because i think normaly the follwing should happen:

1) side_for=2 getting ingnored because [option]s exist
2) the message beeing shown only to side 1.
3) side 1 shows the messagebox
4) side 1 executed {RANDOM 0..200}
5) side 1 sends "which option was chosen" to teh otehr sides
6) the other sides know that option 1 was chosen, and execeute {RANDOM 0..200} too.
--> all sides executed RANDOM once. -> no OOS.

so if it causes OOs then it is most likeley a bug.

[vultraz]

Ah yes. I was wondering as to whether that was still an issue, and to whether that section was still relevant. It's old code I copied from a page that I deleted later, sorry for not catching the side_for issue.

If someone who knows MP could confirm if there are still problems with placement of {RANDOM} (since I can't test right now) that would be helpful.

[Pentarctagon]

The title "Editingwesnoth" should be "EditingWesnoth".

[vultraz]

After speaking with Elvish Pillager, I have removed the section on {RANDOM}, since for one, the code snippet seems to be safe now. I left a link to the EventWML section on MP safety.

The title "Editingwesnoth" should be "EditingWesnoth".

This was happening the other day for me, but now it appears as EditingWesnoth for some reason.

[Iris]

The title displayed by MW honors the case in the URL, not the canonical page name.

[vultraz]

Does anyone know what the title of this page is supposed to be? Espreon indicates it's related to the Finnish translation, but the title contains malformed Unicode.

http://wiki.wesnoth.org/Yksikk%C3%83%C2%B6lista

[zookeeper]

Does anyone know what the title of this page is supposed to be? Espreon indicates it's related to the Finnish translation, but the title contains malformed Unicode.

http://wiki.wesnoth.org/Yksikk%C3%83%C2%B6lista

It should be "Yksikkölista".

[Max]

just in case anyone anyone is bored - there's a couple of tutorial pages from Sgt. Groovy that are now useless because of dead links to images. most of them could be salvaged from web.archive.org:
http://forums.wesnoth.org/viewtopic.php?f=23&t=18060

[vultraz]

Big thanks to Max and AI for finding and moving many of the art tutorial images from external hosting to wesnoth.org. I was going to deal with that eventually, but it's nice to have someone deal with it first/

[Chewan]

… and big thanks to vultraz, too, for taking the trouble to do something about the wiki !

[iceiceice]

The section that is most desperately in need of clean up is the AI pages IMO. There is a ton of very misleading info there that runs the gamut in terms of age, and very little that is actually up-to-date or accurate. Someone should take responsibility for fixing that.

Edit: Here are some pages (that I know of) that should be updated / deleted and replaced:

WritingYourOwnAI
ReferencePythonAPI
PythonTestScript <-- If python AI was indeed removed in Wesnoth 1.5 then this page and the previous should be nuked
Customizing_AI_in_Wesnoth_1.8
LuaAI_New_Syntax <-- this sounds like it should be merged in as a section of the LuaAI page
CompositeAI <-- basically a stub, very little information here

Many ai directory C++ files are not listed here or explained anywhere: AI_Module
Most of the listings towards the end are so terse and devoid of explanation as to be totally useless.

Additionally there is *no* information explaining the working of C++ ai files, how the system is intended to work or how modders are supposed to interact with them, and in fact many misleading or outright wrong comments in these files.

We desperately need an updated and accurate version of the content of the "WritingYourOwnAI" C++ section. If nowadays that means a guide to making custom aspects, goals, and stages for CompositeAI, then these should be given, ideally with walkthroughs of example code to help get someone started.

Edit: Also, a strange comment appears here in the wiki General_RCA_AI_Howto#Modifying_AI_behavior_using_the_cpp_engine

* Modifying the C++ source code -- not useful for dynamically altering AI behavior in existing versions (but useful for committing bug-fixes to future versions of Wesnoth)

This should obviously be revisited. To state the obvious, this is an open source project... We should be welcoming anyone to modify the source code of wesnoth in any productive way to make contributions, and in fact encouraging them and documenting things to help them do so... I hope its just a misunderstanding, but in context it seems a bit troubling.

Edit: I just noticed that buried in this page Customizing_AI_in_Wesnoth_1.8 is a section that contains some info along the lines I'm talking about above: Customizing_AI_in_Wesnoth_1.8#how_AI_works.2C_a_short_developer-oriented_overview

Anyways this should be fleshed out and made into an actual wiki page with details rather than a hand-waving irc log, and updated and made visible.

[AI]

Edit: Also, a strange comment appears here in the wiki General_RCA_AI_Howto#Modifying_AI_behavior_using_the_cpp_engine

* Modifying the C++ source code -- not useful for dynamically altering AI behavior in existing versions (but useful for committing bug-fixes to future versions of Wesnoth)

That just means that C++ patches are useless for altering the behaviour of stable releases, though they can be accepted for future stable branches.

[vultraz]

I went through and deleted and unlinked the following pages related to the Python AI API:

• GetDestinationsByUnitQuestion
• GetDestinationsByUnitTestScript
• PythonAISampleCode
• PythonTestScript
• ReferencePythonAPI

The other pages I'll have to look into further. Any AI-savvy devs would be of great use here to help with creating a good, solid AI reference.

[iceiceice]

I have moved all of the WSNPP pages to the tactics category, as it looks like some of them had already been moved over and it seems a better place for them. Maybe going to categorize some other uncategorized pages now...

Edit: I nominate for deletion:
Canvas_Next <-- Actually already unlinked.
DotD
Dwarvish_Units
Eastern_History <-- Actually this is already unlinked
Edition <-- This looks like a duplicate
Etiquette
GIT-SVN <-- Already unlinked
GoodCommitCommentingPractice <-- I moved this to development. But probably it should be merged with something or deleted.
Good_Ideas
On this page http://wiki.wesnoth.org/index.php?title ... 0&offset=0
I have malformed link it seems? http://wiki.wesnoth.org/Http://www.exam ... cool_coder
Not sure what that is but it should probably be deleted.

Here's an odd page: MultiplayerServerBots
Never knew about this, I guess we don't have any bots? I have thought at various point about writing one. Maybe we should finish writing this? I have added a link from here: MultiplayerServerWML

Mystic-Group <-- Should we contact someone about this or just assume it is inactive
Typography_Style_Guide <-- From note I guess this should be deleted?
UI_Style_Guide <-- Maybe move to development? Is this up to date?
UMCDialog:TFoW
Unit_composition <-- Already unlinked
Weapon_Selection_and_Damage_Estimation

Hmm... Should we move the unlinked & many years old pages which are uncategorized to a category like "Garbage" or something?

Should we make a category for all SOC pages, or Old SOC pages?

Edit: I just noticed this: Category:Candidates_for_deletion
Is it a good idea to unlink things and move them there?

Edit: I created a category for "WML for complete beginners" and also a category "WML Tips" that seemed appropriate for a few uncategorized articles.