We should build a wiki

[MikiHeart]

I'm thinking that it could be a very good idea to build a wiki, or have an addon for vbulletin that creates a Wiki.

Something that we can all edit and add to, but have moderators approve edits (So we don't have any trolls come in and take over).

Then we can add our mods, guides, tips, and it's all in one easy place for people to get to.

[rickasawr]

I would like to see this happen!

As a new user of the script, a wiki would be very informative and is easier navigating than thread posts on forums for information.

[Kyttias]

I vote no. There are many versions of the script, far less than a dozen mods for each, and users would have to sign up for the wiki to ask questions on a separate discussion page. And as a mod maker, I would have to post and answer questions in two locations and then refer people who ask questions to the opposite site where the same question may have already been asked, rather than repeat myself.

There is already a perfectly convenient category on this site for mods (which are even conveniently organized by version). I don't see bulletin board software with a wiki for mods. Or any content management system, really. Save wikis for games and tv shows.

What we need is documentation and a github repository, as these are appropriate resource outlets for code. I don't want to see a wiki until those two are 100% done.

[MikiHeart]

There are all kinds of mods for vbulletin, including a wiki. So doesn't have to be a separate place. I think it's better than the forums, because the forums are all over the place.

The mods section is very unorganized. There are people asking for help, there are mods that have been removed, and mods that aren't updated.

The wiki would also include the full documentation. Right now, everything is all over the place and you have to search through everything to find what is useful and what is not. Where an updated and managed wiki would be a lot better.

[IntoRain]

If the code was fully documented, documentation would be automatically made with specific tools like doxygen (yes, it generates its own wiki). I think it's more useful to document the classes and functions directly, instead of using a wiki

[Hall of Famer]

Well the next major version will have documentation for each class, property and method. Mys v1.3.x does not have documentation though, and I do not plan to add one in future. I think a wiki sounds good, you may research on mediawiki or wikia. Let me know which one you like better.

[rickasawr]

After seeing the idea for documentation, i agree that there should be a documentation instead of a wiki because im having trouble figuring out everything about the script. A documentation would be very usefull and very help, i hope to see one in the future!

[Kyttias]

I'm trying to build some sort of documentation here, but mostly for my own reference, and it's far from done. ^^;

[MikiHeart]

I don't know much about documentation, I just know that most ones I've seen are just simple html pages.

Also HoF, any timeline for the next version? I know you were planning to release it last year but life always gets in the way of things (Damn life and living and stuff lol)

rickasawr: Have a look at Kyttias' documentation, it's looking really good.

[Hall of Famer]

Originally Posted by MikiHeart

I don't know much about documentation, I just know that most ones I've seen are just simple html pages.

Also HoF, any timeline for the next version? I know you were planning to release it last year but life always gets in the way of things (Damn life and living and stuff lol)

rickasawr: Have a look at Kyttias' documentation, it's looking really good.

I cannot give a precise time of when the next version will be released, but it should be this year. If I get a job soon and life starts to click, it can be in the summer, otherwise it will be later. I think the main issue right now is that the development stage of the script is a bit mysterious to you all at this point, it will change soon and in about a month or two I will begin posting updates on the new features implemented for the new version so waiting will not be as boring as it is now.

The fact is that the new version ends up being almost a complete rewrite of the older version, it really feels like version 2.0 rather than 1.4. But I guess you understand why this is necessary coming from the old Rusnak adoptables era. The old code BMR wrote was hard to extend and maintain, so at some point I will have to do this anyway.