So Cheng and I talked for a little while yesterday. It looks like we have about 375 English articles in Troubleshooting and How to. That's about 70 more than Webtrends turns up. Those 70 get less than 100 visits/month so we thought they're probably good candidates for the archive. Cheng will have to run a script to generate a list of them.
For the bottom half of our articles that webtrends sees (about 5% of our visits), we tried looking at them with these criteria:
- Keep articles that are linked to from Firefox.
- Keep documentation for other products (mobile, sync, home) and Army of Awesome since they can't be expected to compete with Firefox articles for views and are still needed.
- Archive old troubleshooting articles. Cheng suggested that a list of troubleshooting articles that get less than 1500 views/month and were older than 6 months are probably obsolete and good candidates for the archive. That turned up a list of 96 articles.
- Consider archiving How to articles with low visits that seem either out of scope (e.g. Configuring Trend Micro Internet Security) or just something people don't seem to need help with (e.g. How to make Firefox automatically dial up). . This one is pretty subjective and one that I'm sure everyone will want to discuss. I came up with a list of 27.
There are probably others (I think we have a few different updating/upgrading Firefox articles) but this seemed like a good place to start. This would leave us with a KB of about 200 or so "current" articles.
We talked a little bit about the other questions that Cheng listed above:
- How do we let USERS know an article may be archived and possibly out of date (and point to newer resources if needed)? We like the idea of a note at the top of the article.
- How do we let CONTRIBUTORS know an article is archived and not to bother with localization/updates?
We need some way to make these not show up on localization dashboards. Other than that (and the big note at the top) we didn't discuss anything other than our normal types of communication. Maybe an email notification could be sent when an article's status changed (just like you get when there is a new approved version)?
- How do we handle internal links to that article? We didn't talk about this. Though I don't think any other thing we talked about would break links or make them work differently.
- Should we ever archive inproduct articles (for example linked-to from a rare error message)? We didn't really talk about this. I think we/I might have said maybe.
- Should we have different standards for l10n vs maintaining an English version? This seemed like a different discussion.
- How should we indicate an archived article in search results? We talked about having them de-prioritized in search results — showing up at the end of the results.
We also talked a little bit about how this could be implemented:
We could create a template of the archive message and add it to the articles. We also need some way of identifying the articles internally. We could add a new category called "Archive." This would allow us to add the template automatically and identify the articles for search results. Cheng though that having an Archive category show up in the breadcrumbs was not a great solution. We could just add a field to each article called "archive" that can be checked inside the admin interface. That could provide what we need for search results but I'm not sure if anything could be done with adding the note automatically.
We talked a little about what would cause us to un-archive an article. This seems to be one of those things we'd just have to monitor and use our judgement for. We'd definitely see things like an archive article getting lots of views. Other than that it would have to be a combination of whether we have any current issues that are a re-occurrence of an old issue. For example, we have Firefox takes a long time to start up which used to be Firefox takes several minutes to start up and was about an issue fixed in 3.5.1. The old article would fall into that category of old troubleshooting articles that get less than 1500 visits/month. We know this is still an issue (though due to different causes) so it seems worth it to rewrite the article and keep it active.
So Cheng and I talked for a little while yesterday. It looks like we have about 375 English articles in Troubleshooting and How to. That's about 70 more than Webtrends turns up. Those 70 get less than 100 visits/month so we thought they're probably good candidates for the archive. Cheng will have to run a script to generate a list of them.
For the bottom half of our articles that webtrends sees (about 5% of our visits), we tried looking at them with these criteria:
# Keep articles that are linked to from Firefox.
# Keep documentation for other products (mobile, sync, home) and Army of Awesome since they can't be expected to compete with Firefox articles for views and are still needed.
# Archive old troubleshooting articles. Cheng suggested that a list of troubleshooting articles that get less than 1500 views/month and were older than 6 months are probably obsolete and good candidates for the archive. That turned up a list of 96 articles.
# Consider archiving How to articles with low visits that seem either out of scope (e.g. [[Configuring Trend Micro Internet Security]]) or just something people don't seem to need help with (e.g. [[How to make Firefox automatically dial up]]). . This one is pretty subjective and one that I'm sure everyone will want to discuss. I came up with a list of 27.
There are probably others (I think we have a few different updating/upgrading Firefox articles) but this seemed like a good place to start. This would leave us with a KB of about 200 or so "current" articles.
We talked a little bit about the other questions that Cheng listed above:
#How do we let USERS know an article may be archived and possibly out of date (and point to newer resources if needed)? We like the idea of a note at the top of the article.
#How do we let CONTRIBUTORS know an article is archived and not to bother with localization/updates?
We need some way to make these not show up on localization dashboards. Other than that (and the big note at the top) we didn't discuss anything other than our normal types of communication. Maybe an email notification could be sent when an article's status changed (just like you get when there is a new approved version)?
#How do we handle internal links to that article? We didn't talk about this. Though I don't think any other thing we talked about would break links or make them work differently.
#Should we ever archive inproduct articles (for example linked-to from a rare error message)? We didn't really talk about this. I think we/I might have said maybe.
#Should we have different standards for l10n vs maintaining an English version? This seemed like a [https://support.mozilla.com/en-US/forums/contributors/704982 different discussion].
#How should we indicate an archived article in search results? We talked about having them de-prioritized in search results — showing up at the end of the results.
We also talked a little bit about how this could be implemented:
We could create a template of the archive message and add it to the articles. We also need some way of identifying the articles internally. We could add a new category called "Archive." This would allow us to add the template automatically and identify the articles for search results. Cheng though that having an Archive category show up in the breadcrumbs was not a great solution. We could just add a field to each article called "archive" that can be checked inside the admin interface. That could provide what we need for search results but I'm not sure if anything could be done with adding the note automatically.
We talked a little about what would cause us to un-archive an article. This seems to be one of those things we'd just have to monitor and use our judgement for. We'd definitely see things like an archive article getting lots of views. Other than that it would have to be a combination of whether we have any current issues that are a re-occurrence of an old issue. For example, we have [[Firefox takes a long time to start up]] which used to be Firefox takes several minutes to start up and was about an issue fixed in 3.5.1. The old article would fall into that category of old troubleshooting articles that get less than 1500 visits/month. We know this is still an issue (though due to different causes) so it seems worth it to rewrite the article and keep it active.