Knowledge Base changes: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
(added "Removing obsolete information", archived four topics)
 
(112 intermediate revisions by 8 users not shown)
Line 4: Line 4:
*It would be nice to have a place where new editors can introduce themselves and meet existing editors.
*It would be nice to have a place where new editors can introduce themselves and meet existing editors.
*It would be good to allow new editors to safely propose content changes (minor or major) prior to implementing them.
*It would be good to allow new editors to safely propose content changes (minor or major) prior to implementing them.
*It would be good to have a central location to discuss the style, content and organisation of this Knowledge Base. (Some of the ideas in [[Talk:Knowledge Base]] can be migrated here, leaving that page solely for discussion of the front page article itself.
*It would be good to have a central location to discuss the style, content and organization of this Knowledge Base. (Some of the ideas in [[Talk:Knowledge Base]] can be migrated here, leaving that page solely for discussion of the front page article itself.
*This page was an attempt to address incidents that have occured on the KB where some groups of editors have been unaware of major changes being made by other groups of editors.
*This page was an attempt to address incidents that have occurred on the KB where some groups of editors have been unaware of major changes being made by other groups of editors.


This page is the primary place to ''announce'' new suggestions. Whenever possible, issues should be ''discussed'' in a more appropriate place, such as the discussion page of the article or category that the suggestion affects.
This page is the primary place to ''announce'' new suggestions. Whenever possible, issues should be ''discussed'' in a more appropriate place, such as the discussion page of the article or category that the suggestion affects. Once suggestions are resolved, they are moved to [[Knowledge Base changes/Archive]].


Once suggestions are resolved, they are moved to [[Knowledge Base changes/Archive]].
You can request somebody create an article at [[Requested articles]] .


==Welcome to new editors==
==Copyright/License problems==
Hello! Great to have you here. Please add a comment here :-)
I suggest we think about adding a short "Copyright/License problems" section in [[Rules_and_guidelines]] that sets peoples expectations on what they can legitimately copy/modify. I'm splitting this out as a separate topic from "Using external sources and references in KB articles". Please discuss this at [[Talk:Rules_and_guidelines]] . [[User:Tanstaafl|Tanstaafl]] 08:32, 20 January 2008 (UTC)


* Hello Knowledge Base! FJ reporting to duty! *bows at all* [[User:FatJohn|FatJohn]] 11:30, 3 January 2006 (UTC)
Roland Tanglao (tech support lead at Mozilla Messaging) is going to talk to Kerz about the possibility of our using a license compatible with the license SuMoMo (The official knowledge base at support.mozillamessaging.com) uses. The issue came up when we planned some events where people on the tb-support-crew AT mozilla.org mailing list (mainly from the MozillaZine and Mozilla Messaging/GetSatisfaction communities) collaborate on writing KB articles. They are initially developed here and then ported to their site. That doesn't raise any legal issues if they are started from scratch. However, someday we may want to merge content from several articles (some of which are on their site) when creating a new article, and there is always the issue of not being able to use updates added to the SuMoMo version of the article on this sites version of the same article unless you start spending a lot of effort tracking and justifying stuff.
* I guess I'm new, I am "name already taken" from the forums, hello to everyone! --[[User:Lethargy|Lethargy]] 21:34, 10 May 2006 (UTC)


==Knowledge Base changes==
See the [http://kb.mozillazine.org/Knowledge_Base_changes/Archive#License_issues archive of license issues]. [[User:Tanstaafl|Tanstaafl]] 11:39, 19 November 2010 (UTC)
A discussion by interested parties regarding the MozillaZine Knowledge Base, in the context of planning for improved Mozilla end-user support, is taking place. Details at http://groups.google.com/group/mozilla.support.planning
<snip>
Forum discussion of end user support, including the KB, [http://forums.mozillazine.org/viewtopic.php?t=494282&start=75 here]. [[User:Alice Wyman|Alice]] 12:34, 8 May 2007 (UTC)


'''Update:''' Minutes of the end-user support meetings were posted to the [http://groups.google.com/group/mozilla.support.planning mozilla.support.planning newsgroup], along with an announcement linking to drafts of a [http://wiki.mozilla.org/Support:Overview Firefox Support Overview] and [http://wiki.mozilla.org/Support:PRD  Support Product Requirements Document].  Proposals related to the KB include one log-in for forums and knowledge base management, account levels (admin, senior moderator, moderator, senior editor, editor, volunteer) as well as analysis and metrics to include top viewed articles (problems).  Division of articles into  "How To’s" (tutorials or best practices initially populated with content from “Firefox Help”) and "Troubleshooting" (“support” that helps users solve problems) was proposed, with the troubleshooting section being initially populated with ''MozillaZine Knowledge Base content that will be organized in a tagging structure that incorporated most frequently accessed questions''. Creation of ''KB style guides'' and ''editorial approval processes'' for content and style were also proposed. See http://wiki.mozilla.org/Support:PRD#Knowledge_base_requirements for details. [[User:Alice Wyman|Alice]] 10:57, 18 May 2007 (UTC)
==Using the new SeaMonkey category==
A new [[:Category:SeaMonkey]] was created awhile back, which went under my radar ;-).  I was thinking, why not use this new category to track SeaMonkey 2 articles for now? I started a Discussion page here: [[:Category talk:SeaMonkey]] [[User:Alice Wyman|Alice]] 14:36, 9 February 2009 (UTC)


==Screenshots - confusion?==
[http://kb.mozillazine.org/User:Skierpage Skierpage] is looking for advice on how to update old Mozilla Suite stuff for SeaMonkey, especially for Linux. [[User:Tanstaafl|Tanstaafl]] 11:44, 19 November 2010 (UTC)
I'm worried about us posting screenshots of dialogs to describe how to do something and some poor granny trying to actually click on buttons in the screenshot. What can we do about this?--[[User:Np|Np]] 16:59, 18 May 2007 (UTC)
: I don't think there is much we can do to prevent people from making silly mistakes, except maybe to add something like "Sample image: do not click" to each screenshot ..... it's funny, because I've tried using scroll bars on screenshots myself, on occasion :-D [[User:Alice Wyman|Alice]] 19:44, 18 May 2007 (UTC)


==Application specific articles==
==Replacement of Profile Manager==
I've noticed a recent trend towards having more articles be application specific. My first impression is that this seems to be due to


* Recent awareness that you can include screen shots in the article. [[Creating_a_new_Firefox_profile_on_Windows]] and [[Corrupt_localstore.rdf]] for example are articles that at one time would have at least been written to cover both Firefox and SeaMonkey, and might have also covered Thunderbird.
The profile manager is going to be eliminated after Firefox 4.0. [http://www.ghacks.net/2011/01/19/firefox-profile-manager-to-be-removed-soon/] [http://forums.mozillazine.org/viewtopic.php?f=38&t=2066609] Thunderbird will probably also do the same. [http://forums.mozillazine.org/viewtopic.php?f=29&t=2073455] The separate profile manager utility is not designed for end users, and its not clear yet whether it will even be bundled with the Mozilla application.  
* Frustration over the density and problems in navigating an article that cover many applications, such as [[Profile_folder]]
* Mozilla's plans to create their own knowledge base, using migrated Firefox articles from mozillaZine.  


I've frequently pushed for Thunderbird specific versions of some articles, including one for [[Profile_folder]] but I have mixed feelings about this trend. There are some cases where it makes a lot of sense to address multiple applications in one article. I'm also concerned over what effect this has on whether editors who tend to focus on browser specific articles will continue working on the mozillaZine knowledge base after Mozilla creates their own for just Firefox. Thoughts?
How do we want to handle documenting both? Its already very awkward documenting how to use the profile manager for multiple applications and multiple operating systems in one article. That is the reason why [[Moving_your_profile_folder_-_Thunderbird]] was created for example. Given the different release schedules for Firefox, SeaMonkey, and Thunderbird, and how some users keep using old major versions for a very long time we will probably have to deal with both for at least several years.


As an aside, does anybody object to my creating a calendar category? [[User:Tanstaafl|Tanstaafl]] 22:28, 18 May 2007 (UTC)
Do we want to adopt some naming convention in other articles to make it clear which one we're talking about or do we want to refer to both as the profile manager?  


:I can see advantages in combined application articles such as [[Profile Folder]].  One reason being, the same files may be used in different application profiles (in some cases they can be copied over directly, as with mimeTypes.rdf and bookmarks.html).  Firefox users are in the majority, though,  and it's hard for editors  who don't have  experience with Mozilla Suite or SeaMonkey to include it in articles.  I use SeaMonkey about as often as I use Firefox (and I still have Mozilla Suite installed as well) so I try to include SeaMonkey where possible,  such as in plugin articles.  In the case of [[Changing media handling behaviour]] I've included screenshots for both Firefox and SeaMonkey.  Regarding ''Mozilla's plans to create their own knowledge base, using migrated Firefox articles from mozillaZine'',  when that happens and if my contributions are no longer needed for Firefox articles because Mozilla folks have taken them over and restrict new articles to selected editors, I can always go over to SeaMonkey and start fixing up that KB a bit. [[User:Alice Wyman|Alice]] 00:39, 19 May 2007 (UTC)
I realize this is early but I'd like to document how to use the replacement with Thunderbird (if only to get more people to try it and provide feedback to the author) and don't want to make that a isolated stand alone article. [[User:Tanstaafl|Tanstaafl]] 02:27, 21 January 2011 (UTC)


:I think combined application articles are good when the info provided only differs slightly, for example by a [[Object has been blocked|single menu sequence]]. In [[profile folder]], about half the article doesn't apply to any given user. [[Creating a new Firefox profile on Windows]]  was created not to avoid mentioning SeaMonkey, but to avoid the "but if"s, "except if"s , and "you can also"s that plague the profile manager article.--[[User:Np|Np]] 01:41, 19 May 2007 (UTC)
:I've already added this note to the top of the [[Profile Manager]] article:<br>
 
:{| {{prettytable}}
==Removing obsolete information==
|-
I notice that some articles, such as [[Multiple_SMTP_servers_-_Thunderbird]] have multiple sections for obsolete versions. I suggest we add a rule of thumb that such text should be removed if its for a version thats more than two major releases ago to [[In-house_style]] . i.e. since Thunderbird is at 2.0.0.6 keep the text about 1.5 or later but dump the 1.0.x text if it simplifies the article. [[User:Tanstaafl|Tanstaafl]] 01:17, 13 October 2007 (UTC)
|'''''Note:''' Mozilla is planning to remove the built-in Profile Manager  from future Mozilla applications (after Firefox 4.0) and a standalone "Profile Manager" application will be available. "Profile Manager 1.0 Beta 1" is described [http://jagriffin.wordpress.com/2011/01/11/profilemanager-1-0_beta1 here]. For more information, see [http://www.ghacks.net/2011/01/19/firefox-profile-manager-to-be-removed-soon/ this blog post] and [https://developer.mozilla.org/en/Profile_Manager this article at MDC]. [http://forums.mozillazine.org/viewtopic.php?p=10275581#p10275581] [https://bugzilla.mozilla.org/show_bug.cgi?id=214675] [https://bugzilla.mozilla.org/show_bug.cgi?id=539524]''
|-
|}
:According to [https://bugzilla.mozilla.org/show_bug.cgi?id=539524#c22 bug 539524 comment 22] the standalone PM application will probably not be bundled with future Firefox downloads when it is removed from Firefox and  will be a separate, optional download.   I thought that we might make a template similar to the above note and add it to the top of all articles about profiles.  When the built-in Profile Manager is actually removed (sometime after Firefox 4.0) we could add  something to the effect that the article or article section ''applies to Firefox 4.0 and below.'' We could then create a new "Profile Manager application" or "Profile Manager utility" article and link to it, just like we have  for the [[MozBackup]] standalone utility. [[User:Alice Wyman|Alice]] 14:10, 21 January 2011 (UTC)

Latest revision as of 14:10, 21 January 2011

This page has been created for several reasons.

  • It would be nice to have a place where new editors can introduce themselves and meet existing editors.
  • It would be good to allow new editors to safely propose content changes (minor or major) prior to implementing them.
  • It would be good to have a central location to discuss the style, content and organization of this Knowledge Base. (Some of the ideas in Talk:Knowledge Base can be migrated here, leaving that page solely for discussion of the front page article itself.
  • This page was an attempt to address incidents that have occurred on the KB where some groups of editors have been unaware of major changes being made by other groups of editors.

This page is the primary place to announce new suggestions. Whenever possible, issues should be discussed in a more appropriate place, such as the discussion page of the article or category that the suggestion affects. Once suggestions are resolved, they are moved to Knowledge Base changes/Archive.

You can request somebody create an article at Requested articles .

Copyright/License problems

I suggest we think about adding a short "Copyright/License problems" section in Rules_and_guidelines that sets peoples expectations on what they can legitimately copy/modify. I'm splitting this out as a separate topic from "Using external sources and references in KB articles". Please discuss this at Talk:Rules_and_guidelines . Tanstaafl 08:32, 20 January 2008 (UTC)

Roland Tanglao (tech support lead at Mozilla Messaging) is going to talk to Kerz about the possibility of our using a license compatible with the license SuMoMo (The official knowledge base at support.mozillamessaging.com) uses. The issue came up when we planned some events where people on the tb-support-crew AT mozilla.org mailing list (mainly from the MozillaZine and Mozilla Messaging/GetSatisfaction communities) collaborate on writing KB articles. They are initially developed here and then ported to their site. That doesn't raise any legal issues if they are started from scratch. However, someday we may want to merge content from several articles (some of which are on their site) when creating a new article, and there is always the issue of not being able to use updates added to the SuMoMo version of the article on this sites version of the same article unless you start spending a lot of effort tracking and justifying stuff.

See the archive of license issues. Tanstaafl 11:39, 19 November 2010 (UTC)

Using the new SeaMonkey category

A new Category:SeaMonkey was created awhile back, which went under my radar ;-). I was thinking, why not use this new category to track SeaMonkey 2 articles for now? I started a Discussion page here: Category talk:SeaMonkey Alice 14:36, 9 February 2009 (UTC)

Skierpage is looking for advice on how to update old Mozilla Suite stuff for SeaMonkey, especially for Linux. Tanstaafl 11:44, 19 November 2010 (UTC)

Replacement of Profile Manager

The profile manager is going to be eliminated after Firefox 4.0. [1] [2] Thunderbird will probably also do the same. [3] The separate profile manager utility is not designed for end users, and its not clear yet whether it will even be bundled with the Mozilla application.

How do we want to handle documenting both? Its already very awkward documenting how to use the profile manager for multiple applications and multiple operating systems in one article. That is the reason why Moving_your_profile_folder_-_Thunderbird was created for example. Given the different release schedules for Firefox, SeaMonkey, and Thunderbird, and how some users keep using old major versions for a very long time we will probably have to deal with both for at least several years.

Do we want to adopt some naming convention in other articles to make it clear which one we're talking about or do we want to refer to both as the profile manager?

I realize this is early but I'd like to document how to use the replacement with Thunderbird (if only to get more people to try it and provide feedback to the author) and don't want to make that a isolated stand alone article. Tanstaafl 02:27, 21 January 2011 (UTC)

I've already added this note to the top of the Profile Manager article:
Note: Mozilla is planning to remove the built-in Profile Manager from future Mozilla applications (after Firefox 4.0) and a standalone "Profile Manager" application will be available. "Profile Manager 1.0 Beta 1" is described here. For more information, see this blog post and this article at MDC. [4] [5] [6]
According to bug 539524 comment 22 the standalone PM application will probably not be bundled with future Firefox downloads when it is removed from Firefox and will be a separate, optional download. I thought that we might make a template similar to the above note and add it to the top of all articles about profiles. When the built-in Profile Manager is actually removed (sometime after Firefox 4.0) we could add something to the effect that the article or article section applies to Firefox 4.0 and below. We could then create a new "Profile Manager application" or "Profile Manager utility" article and link to it, just like we have for the MozBackup standalone utility. Alice 14:10, 21 January 2011 (UTC)