WIP wiki cleanup and update

Discussion of all aspects of the website, wiki, and forums, including support requests and new ideas.

Moderators: Forum Moderators, Developers

User avatar
vultraz
Community Manager
Posts: 954
Joined: February 7th, 2011, 12:51 pm
Location: Dodging Daleks

WIP wiki cleanup and update

Post by vultraz » March 16th, 2014, 6:45 pm

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! :augh: 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.
Creator of Shadows of Deception (for 1.12) and co-creator of the Era of Chaos (for 1.12/1.13).
SurvivalXtreme rocks!!!
What happens when you get scared half to death...twice?

gfgtdf
Developer
Posts: 1203
Joined: February 10th, 2013, 2:25 pm

Re: WIP wiki cleanup and update

Post by gfgtdf » March 16th, 2014, 7:27 pm

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.
Scenario with Robots SP scenario (1.11/1.12), allows you to build your units with components, PYR No preperation turn 1.12 mp-mod that allows you to select your units immideately after the game begins.

User avatar
vultraz
Community Manager
Posts: 954
Joined: February 7th, 2011, 12:51 pm
Location: Dodging Daleks

Re: WIP wiki cleanup and update

Post by vultraz » March 16th, 2014, 7:38 pm

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.
Creator of Shadows of Deception (for 1.12) and co-creator of the Era of Chaos (for 1.12/1.13).
SurvivalXtreme rocks!!!
What happens when you get scared half to death...twice?

User avatar
Pentarctagon
Forum Administrator
Posts: 4102
Joined: March 22nd, 2009, 10:50 pm
Location: Earth (occasionally)

Re: WIP wiki cleanup and update

Post by Pentarctagon » March 16th, 2014, 8:01 pm

The title "Editingwesnoth" should be "EditingWesnoth".
99 little bugs in the code, 99 little bugs
take one down, patch it around
-2,147,483,648 little bugs in the code

User avatar
vultraz
Community Manager
Posts: 954
Joined: February 7th, 2011, 12:51 pm
Location: Dodging Daleks

Re: WIP wiki cleanup and update

Post by vultraz » March 19th, 2014, 4:50 am

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.
Pentarctagon wrote:The title "Editingwesnoth" should be "EditingWesnoth".
This was happening the other day for me, but now it appears as EditingWesnoth for some reason.
Creator of Shadows of Deception (for 1.12) and co-creator of the Era of Chaos (for 1.12/1.13).
SurvivalXtreme rocks!!!
What happens when you get scared half to death...twice?

User avatar
Iris
Site Administrator
Posts: 6588
Joined: November 14th, 2006, 5:54 pm
Location: Chile
Contact:

Re: WIP wiki cleanup and update

Post by Iris » March 19th, 2014, 5:38 am

The title displayed by MW honors the case in the URL, not the canonical page name.
Author of the unofficial UtBS sequels Invasion from the Unknown and After the Storm.

User avatar
vultraz
Community Manager
Posts: 954
Joined: February 7th, 2011, 12:51 pm
Location: Dodging Daleks

Re: WIP wiki cleanup and update

Post by vultraz » March 24th, 2014, 4:02 am

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
Creator of Shadows of Deception (for 1.12) and co-creator of the Era of Chaos (for 1.12/1.13).
SurvivalXtreme rocks!!!
What happens when you get scared half to death...twice?

User avatar
zookeeper
WML Wizard
Posts: 9740
Joined: September 11th, 2004, 10:40 pm
Location: Finland

Re: WIP wiki cleanup and update

Post by zookeeper » March 24th, 2014, 7:17 am

vultraz wrote: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
Posts: 1449
Joined: April 13th, 2008, 12:41 am

Re: WIP wiki cleanup and update

Post by Max » March 25th, 2014, 7:32 am

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

User avatar
vultraz
Community Manager
Posts: 954
Joined: February 7th, 2011, 12:51 pm
Location: Dodging Daleks

Re: WIP wiki cleanup and update

Post by vultraz » April 4th, 2014, 7:37 am

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/ :)
Creator of Shadows of Deception (for 1.12) and co-creator of the Era of Chaos (for 1.12/1.13).
SurvivalXtreme rocks!!!
What happens when you get scared half to death...twice?

Chewan
Posts: 135
Joined: December 19th, 2013, 1:40 am

Re: WIP wiki cleanup and update

Post by Chewan » April 4th, 2014, 11:07 am

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

User avatar
iceiceice
Developer
Posts: 1056
Joined: August 23rd, 2013, 2:10 am

Re: WIP wiki cleanup and update

Post by iceiceice » April 6th, 2014, 12:25 am

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
General_RCA_AI_Howto wrote: * 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
Developer
Posts: 2394
Joined: January 31st, 2008, 8:38 pm

Re: WIP wiki cleanup and update

Post by AI » April 6th, 2014, 2:54 pm

iceiceice wrote:Edit: Also, a strange comment appears here in the wiki General_RCA_AI_Howto#Modifying_AI_behavior_using_the_cpp_engine
General_RCA_AI_Howto wrote: * 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.

User avatar
vultraz
Community Manager
Posts: 954
Joined: February 7th, 2011, 12:51 pm
Location: Dodging Daleks

Re: WIP wiki cleanup and update

Post by vultraz » April 6th, 2014, 3:32 pm

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.
Creator of Shadows of Deception (for 1.12) and co-creator of the Era of Chaos (for 1.12/1.13).
SurvivalXtreme rocks!!!
What happens when you get scared half to death...twice?

User avatar
iceiceice
Developer
Posts: 1056
Joined: August 23rd, 2013, 2:10 am

Re: WIP wiki cleanup and update

Post by iceiceice » April 6th, 2014, 7:33 pm

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.
Last edited by iceiceice on April 7th, 2014, 4:08 am, edited 1 time in total.
Reason: Removed links to deleted pages

Post Reply