After much work and double-checking, the Simple Machines Team is proud to announce that the new Online Manual is out of its testing phase. Now, SMF documentation is kept in our Online Manual, which we maintain in a free wiki software provided by MediaWiki.org

The truth is, we've been using the new Online Manual wiki as a production service for some time now, while also refining some things. The skin has had some gradual improvements, we've improved the display of code, implemented a wiki translation tool and refined the SMF MediaWiki integration which makes your SMF login "work" on the wiki.

The wiki is still SMF online documentation that anyone can edit. If you have made at least 10 posts on the SMF forum, you can help on the wiki. If you are interested in contributing to the wiki, please see the information on the Community Portal. Some parts of the wiki are being translated from English into other languages, using a wiki translation tool. So look for more information in the near future about becoming a wiki translator.

Here at SMF, we are using a bridge that allows us to use SMF logins on the wiki. If you are interested in using this bridge on your own site, or helping to develop this bridge, please read more at SMF MediaWiki integration .

If you are interested in writing SMF code, we're always looking, of course. If you catch any bugs, please submit your fixes on the Bug Reports board.

Many thanks to Joshua Dickerson for pushing for the wiki, to SleePy for getting things all set up, and keeping the documentation team informed about what it has needed to do to keep it moving forward, and to Labradoodle-360 for doing the work in the wiki skin. Many more thanks to Emanuele for improving the code tag, for writing a bunch of useful wiki-templates, for working around persistant problems with the translation tool, and for working with the translators and the localization team. The translators are doing a great job translating the SMF 2.0 help into many different languages. Thanks to Illori and Emanuele for moving documents from the old online help to the new wiki, and fixing them up when they got there. Thanks to K@ for helping to reorganize some of the FAQ material, and for improving some of the documentation based on feedback from many SMF users. And thanks to everyone who has fixed and improved wiki documents. We couldn't do it without you.

------------------Edit: A little bit of explanation of Online Manual, Documentation, and the new Wiki. And clarification of some of the work that's gone into making it happen.

« Last Edit: February 15, 2012, 01:49:33 PM by AngelinaBelle »

Logged

Never attribute to malice that which is adequately explained by stupidity. -- Hanlon's Razor

This can get a bit confusing. Some of you call it SMF mediawiki others call it the online manual or just the wiki, it confused me to hell looking for it (the wiki) until I noticed the wiki logo at the bottom of the online manual.Maybe you should change the name in the menu to something like, online wiki, or wiki manual,wiki documentation, wiki help, or something along those lines to save any further confusion,or maybe its only me not been savvy enough

Liam -- having your username shown in the side bar is a feature of the SMF/mediawiki bridge we use.

This bridge allows the wiki to do its logins through SMF, and use SMF's cookies to maintain login sessions.But mediawiki does not support the use of a display name separate from the username. So one or the other had to be chosen.Since the SMF display name is free to be changed by the user, the username seems to me like a logical choice.

But I did not write the bridge.

The bridge seems to work well enough. But I am certain it could be tweaked and improved. If you are interested in experimenting, you are welcome to get a copy of the bridge and work on it. Please read more SMF MediaWiki integration released.

Logged

Never attribute to malice that which is adequately explained by stupidity. -- Hanlon's Razor

I understand what you mean now. It is the untranslated page on the wiki which gives the problem. It could be described as a bug. SMF can check for the page. And the page is there. But we would really rather see the base (English) text if the translated text is not available, not the notice that the text has not been translated.

I think we should discuss this in bugs. I do not know what would be required to fix this problem.

Logged

Never attribute to malice that which is adequately explained by stupidity. -- Hanlon's Razor

ThorstenE

You're joking, right? Well, I have quite a bit of spare time but let's be honest, the german help was ~95% complete and has been totally wiped out by a team decision. You can't expect from someone to do the entire work (again)...

I agree - the change to the new help is a big hassle for the translations.

It would be possible to copy the strings out of the language editor into the wiki translation tool, because the pages on the wiki are > 95% identical to what was in the language editor at the time.But even this will take time, as you can see by the fact that the German wiki translation has not been done.We did not have a tool to automate the proces.

At this time, a few changes have been made to the base (English) pages. These changes were mostly made at the request of translators. This means that, after copying strings from the LE, the translator would need to check if the original had changed, and update the translated string.

Logged

Never attribute to malice that which is adequately explained by stupidity. -- Hanlon's Razor

I agree - the change to the new help is a big hassle for the translations.

It would be possible to copy the strings out of the language editor into the wiki translation tool, because the pages on the wiki are > 95% identical to what was in the language editor at the time.But even this will take time, as you can see by the fact that the German wiki translation has not been done.We did not have a tool to automate the proces.

At this time, a few changes have been made to the base (English) pages. These changes were mostly made at the request of translators. This means that, after copying strings from the LE, the translator would need to check if the original had changed, and update the translated string.