General > Discussion

A Wiki for Each Manual

(1/3) > >>

TC:
This website is well organized. It was a good idea to build the manual, the FAQ, and other parts of the website in a wiki. However, I propose that instead of a single wiki, the website would be better served by multiple wikis. Specifically, I suggest one wiki for administration and development and three wikis for the game manuals 2.2, 2.3, and 2.4.

Organizing the documentation by version is a cleaner approach than organizing it by topic and addressing version differences on each page. If that argument isn't persuasive, consider that documentation is subject to the same revision control issues as source code, and it just makes sense to create a branch for each version.

MediaWiki has the capability to host multiple wikis with a single user base. If the website administrator would like to pursue my multiple-wiki suggestion and wants help with the MediaWiki configuration, just let me know.

-TC

bayo:
Hello.

It is useless and overcomplex. MediaWiki also support subpages and namespaces.

Plus it will create problem to follow editions.

But you are right, we should move some content as u say, but especially game translation, i think.

Duke:

--- Quote from: TC on August 04, 2010, 09:27:49 pm ---... and three wikis for the game manuals 2.2, 2.3, and 2.4.

--- End quote ---
I agree with bayo.
2.2 is obsolete. Few users will want to use 2.2 once 2.3 is out.
2.4 manual is ...  uhm... not really written yet.

TC:
Bayo and Duke,

From your comments, I can't tell whether or not you see my point.

The 2.4 manual hasn't been written yet, but what happens the first time someone wants to document something in 2.4 which is different from 2.3? Do you end up with one wiki page which is ambiguous regarding its applicability; do you end up with one wiki page with a 2.3 section and a 2.4 section; or do you end up with two wiki pages? Having two wiki pages seems like the best structure to me.

-TC

bayo:
Yes, 2 wiki pages is a good choice. For example:

Manual 2.3
Manual 2.3/A sub page
Manual 2.3/Another sub page
...

Manual 2.4
Manual 2.4/A sub page
Manual 2.4/Another sub page
...

Wikibooks works like that without too much problems.

Anyway i dont know the current manual content. And what is about 2.2, 2.3 or 2.4. Maybe the manual page (http://ufoai.ninex.info/wiki/index.php/Manual) is not up to date.

Navigation

[0] Message Index

[#] Next page