WoWInterface

WoWInterface (https://www.wowinterface.com/forums/index.php)
-   Site help, bugs, suggestions/questions (https://www.wowinterface.com/forums/forumdisplay.php?f=18)
-   -   Site Feature Suggestion: WoWInterface Wiki (https://www.wowinterface.com/forums/showthread.php?t=40908)

Mike-N-Go 07-19-11 01:53 AM

Site Feature Suggestion: WoWInterface Wiki
 
WoWInterface.com can benefit from a Wiki.

The main purpose is not to replicate wowwiki.com, but to offer a dedicated, official place for a WoW AddOn Wiki.

I recommend that there be an approval process for the Wiki, and one consideration that pages directly related to a specific AddOn be restricted to approval by the author, or site staff, or whatever the author choses.

One issue is ownership of the text: It should be exclusively owned jointly by WoWInterface and the owner of said AddOn, so an author can directly use the wiki article in his addon or description, without fuss.

A Wiki would be a complement to the site: Some authors do not describe fully in their description; The WoWInterface forums can only go so far, for the forums are more tailored for conversations, not a collaborated document; A quick link from the AddOn's tab, so the page can be brought up quickly.

Most of all, not all authors are good english writers. Were the community help augment some of our weaknesses, we can spend more time coding; more time writing new addons.

What is your opinions (Staff and Members) of an official WoWInterface Wiki?

Vlad 07-19-11 02:09 AM

It's hard to keep such API documentations complete when there are so many.

Currently I use these sites;
wowprogramming
wowpedia
wowwiki

The first is well explained but things that are missing are usually found on wowpedia (the new "wowwiki") or the old wowwiki site that some people keep updating.

Point being if we make another wiki for the API we'd simply add it on the bottom of this list and coders would have to visit 4 sites to check if the API in question has any documentation or not. ;)

I'd suggest partnership of some sort with wowprogramming and keep that updated, it's good and efficient imo.

Mike-N-Go 07-19-11 02:26 AM

Quote:

Originally Posted by Vladinator (Post 241796)
It's hard to keep such API documentations complete when there are so many.

...

Currently I use these sites;
wowprogramming
wowpedia
wowwiki

...

Point being if we make another wiki for the API we'd simply add it on the bottom of this list and coders would have to visit 4 sites to check if the API in question has any documentation or not. ;)

I think you may have missed one of my points.

I will restate:

Code:

One issue is ownership of the text: It should be exclusively owned jointly by WoWInterface and the owner of said AddOn, so an author can directly use the wiki article in his addon or description, without fuss.
The problem is that not everyone with a WoWInterface account is on those sites; the benefit of having a Wiki on WoWInterface would be that the users of the addon would have a simple method to help the author. Not replace the other resources.

Heck, some sort of partnership would be splendid. My main goal would be to give the community access to augment a developer's responsibilities; make our lives easier (hopefully).

And one other thing, have it an 'opt in' thing. And if the dev has not opted in, have the page be a stub along the lines of "This page has not been enabled by the author. Please click here to show your request of this page to the author of XAwsomsauceAddOn."

Mike-N-Go 07-19-11 02:46 AM

Short of a branded/official wiki, what do you (Staff) think about the idea of a universal login? For WoWInterface.com or a partner's wiki? So a user can use the same login for both?

Dolby 07-19-11 08:45 AM

Most of our other sites have a wiki, we don't here because there are a ton of wiki's already popular. It would be bad for the UI community to spread this information even thinner.

Seerah 07-19-11 12:09 PM

To add to this, though... Many authors do not take (full) advantage of their Portals. You can add pages to the portal for documentation of API or other things. There's even a form to build FAQs on the Portal! :)

Vlad 07-19-11 12:19 PM

Here is one idea, having access to PTR we can make a diff and find out what events/widget/API are removed or the arguments changed, hence right before patch one could run a php script on the server to scan all the addons currently flagged as "updated" and flag them as "outdated" if they use events/widgets/API that are touched by the new patch. ;)

Doable but requires a lot of processing and coding time, I fear. :P

Mike-N-Go 07-19-11 01:55 PM

Quote:

Originally Posted by Seerah (Post 241848)
To add to this, though... Many authors do not take (full) advantage of their Portals. You can add pages to the portal for documentation of API or other things. There's even a form to build FAQs on the Portal! :)

I would enjoy to make better use of the portal. Do you have a link to an FAQ on how to use the portal?

Can I upload custom scripts or webpage applications into my portal area, so I could self manage something like a wiki? Or is that currently not doable?

Dolby 07-19-11 02:28 PM

The portal is fairly self explanatory. It has a feature/bug tracking system, FAQ building system, custom pages and news.

No you can not use custom scripts or apps. We don't allow that for security reasons especially since we are hosting addons and we are a target.

Mike-N-Go 07-19-11 07:56 PM

Do you currently offer a 'vanity' sub-domain, that can forward to the portal?

Like, http://Mike-N-Go.WoWInterface.com?

Dolby 07-19-11 08:02 PM

Yes, Clicking it brings me to your portal...

Mike-N-Go 07-20-11 07:28 PM

Quote:

Originally Posted by Dolby (Post 241899)
Yes, Clicking it brings me to your portal...

Ahh.

New news to me.

I typically use my iPad, so testing things can be haphazard.

Mike-N-Go 07-27-11 09:06 AM

Micro-wiki
 
I guess I did not clearly communicate my intent: not for a wiki about API for developers, but a WoWI wiki could be a 'micro wiki' that authors can opt-in on a per-AddOn basis, the micro-wiki could show up under the tabs on he AddOn, and the author could have the option of adding "team members" who want to help, but are not coders: it would be a different set of permissions, sabdboxing this user from uploading an official update or modifying the main description.

This would be good, for the community to pitch in and help AddOn authors who want to get back to coding, not hone English and grammar.

If the wiki was "micro", what do you think about this feature request?


All times are GMT -6. The time now is 03:16 AM.

vBulletin © 2024, Jelsoft Enterprises Ltd
© 2004 - 2022 MMOUI