Pony99CA wrote:I thought that it was obvious. Will every KB article be maintained for years? Probably not. Are all MODs maintained forever? You know that they aren't. So why would somebody expect tutorials to be maintained forever? Putting them in a topic would allow the OP to maintain it if he wished, but nobody can require him to do so.
Well yes, articles should be maintained for as long as they remain active in whatever tutorial medium we have. Even in the current KB, team members will (either on their own or at the request of the author) fix things when they become outdated.
I didn't know that. So when a new version of phpBB comes, one or more people look through the KB articles to ensuer that they're still accurate?
So I am missing why you consider this to be an improvement over the current system.
Even if you don't accept author updates (more below), there's still the searchability factor. The normal phpBB search facility would find KB articles, er, tutorial topics. There would also be the ability to subscribe to the topic. If somebody changed the tutorial, if they also posted that an update was made, everybody subscribed to that tutorial would get notified of the change. Plus, if you subscribed to the forum, you'd get notified of new articles. None of those are possible in the current system (maybe they will be in the new one, but I can't possibly know what's in it
Marshalrusty wrote:We also definitely don't want article authors to have unchecked ability to edit things without someone verifying their accuracy, particularly for KB articles that are often linked to hundreds or thousands of times in the Support Forum.
Fair enough. However, in phpBB 3.1, I believe there will be a post revision facility, so if an author makes a bad update, you could easily undo it.
However, many team members don't seem to link to KB articles when they could. How many times has a team member posted instructions on changing a board logo in the forum instead of linking to the Changing your board logo
KB article? How many times has somebody posted instructions on updating a board without MODs to the latest version instead of linking to the How to update to the latest version of phpBB3
That's not meant to criticize the team members, but to point out that this information is getting placed in the forums already
. And, because it's scattered over many topics, it's unlikely to get updated if the advice becomes outdated.
Marshalrusty wrote:KB articles exist as an extension of the userguide. Where the userguide explains how features work, KB articles explain, perhaps, what the best way to use the feature is, or how to modify it to do something else. KB articles are decisively not like MODs, as we do assume most responsibility for their accuracy and some responsibility for their maintenance.
OK, but as I mentioned before, there are many tutorials and KB-like topics in the forums here. Most may be written by users and not verified for accuracy, but that's not true of all of them -- one that stands out is the anti-spam sticky post
in the Support Forum. That seems exactly
like what you're saying should be in the KB, but there it sits in the forums.
(You may say that's to make it more visible to people visiting the Support Forum, thus preventing repetitive questions about preventing spam, but that could be achieved with a sticky topic that just contained a link to an anti-spam KB article.)
Plus, if you moved the KB articles to a forum, nothing would prevent you from controlling their accuracy. Certain team members would presumably have Moderator permissions for that forum and could update and correct any inaccuracies.
However, maybe if somebody would tell us what features are going to be in the new KB, that would help us understand why a forum, despite the advantages I've listed, is unnecessary. So far, the new KB seems to be a deep, dark, mysterious secret.
And, oh yes, a forum has one more advantage over the new KB -- it could be done in minutes (hours at most). When will the new KB be released? (I know -- we don't have release dates.
So let me ask you a question. What would you lose
by putting the KB articles in a forum? As far as I can tell, you'd lose the Version/Category
information column, and you could simulate that with sub-forums for each Version and Category in a main Tutorial forum. You'd might also lose the cool KB links (like I used above), but perhaps a Moderator could add that type of link at the top of the post in the forum (especially if they had to approve posts in that forum anyway). So I don't think that we'd lose much, if anything, by putting the KB articles in a forum. (Of course, that may depend on what the new KB can do, but -- well, you know.