canmove, Confirmed users, Bureaucrats and Sysops emeriti
3,698
edits
User:Ckoehler/About wiki.mozilla.org: Difference between revisions
User:Ckoehler/About wiki.mozilla.org (view source)
Revision as of 21:54, 10 June 2014
, 10 June 2014closing comments
(closing comments) |
|||
| (10 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
Comments on this document are now closed. Feedback has been incorporated and the new [[MozillaWiki:About]] is now live. | |||
{| class="wikitable" | {| class="wikitable" | ||
|+ style="text-align:left; padding: 5px;" | Request for Comments | |+ style="text-align:left; padding: 5px;" | Request for Comments | ||
| Line 4: | Line 6: | ||
| style="width: 20%; text-align: right; padding: 5px;" | '''date created''' || 2014-05-09 | | style="width: 20%; text-align: right; padding: 5px;" | '''date created''' || 2014-05-09 | ||
|- | |- | ||
| style="width: 20%; text-align: right; padding: 5px;" | '''comments deadline''' || style="color:red;" | 2014-05-26 14:00 UTC | | style="width: 20%; text-align: right; padding: 5px;" | '''comments deadline''' || style="color:red;" | 2014-05-26 14:00 UTC | ||
|- | |- | ||
| style="width: 20%; text-align: right; padding: 5px;" | '''contributors''' || [[User:Ckoehler | Christie Koehler]], Lyre Calliope, Gordon Hemsley, Justin Crawford, Larissa Shapiro, Jennie Rose Halperin, Mark A. Hershberger, and Jason Crowe. | | style="width: 20%; text-align: right; padding: 5px;" | '''contributors''' || [[User:Ckoehler | Christie Koehler]], Lyre Calliope, Gordon Hemsley, Justin Crawford, Larissa Shapiro, Jennie Rose Halperin, Mark A. Hershberger, and Jason Crowe. | ||
| Line 10: | Line 12: | ||
| style="width: 20%; text-align: right; padding: 5px;" | '''status''' || draft | | style="width: 20%; text-align: right; padding: 5px;" | '''status''' || draft | ||
|- | |- | ||
| style="width: 20%; text-align: right; padding: 5px;" | '''To make comments:''' || | | style="width: 20%; text-align: right; padding: 5px;" | '''To make comments:''' || COMMENTS CLOSED See [[MozillaWiki:About]] for updated about page. | ||
|} | |} | ||
| Line 27: | Line 29: | ||
== Purpose == | == Purpose == | ||
This wiki (wiki.mozilla.org, AKA MozillaWiki or WikiMO) is the official public wiki of the Mozilla Project. It | This wiki (wiki.mozilla.org, AKA MozillaWiki or WikiMO) is the official public wiki of the Mozilla Project. It serves as the public memory for the Mozilla community, documenting its projects, planning, processes and teams. Additionally, the wiki seeks to facilitate lively community interaction that empowers contributors to coordinate activities, find support, and make their projects accessible to other contributors across Mozilla. | ||
Additionally, the wiki seeks to facilitate lively community interaction that empowers contributors to coordinate activities, find support, and make their projects accessible to other contributors across Mozilla | |||
This wiki is a publicly available resource for those wanting to learn more about the Mozilla Project. It is not designed nor intended for end-users. If you're looking for user support for any of Mozilla's products, visit [http://support.mozilla.org support.mozilla.org]. | |||
== What content is appropriate for the Wiki? == | == What content is appropriate for the Wiki? == | ||
* Any content | * Any content that is related to the on-going planning, coordination or other contribution activities of current or past Mozilla projects. | ||
* Any content pertaining to Mozilla's mission, strategy or history. | * Any content pertaining to Mozilla's mission, strategy or history. | ||
* Any content that supports Mozilla's mission or community. | * Any content that supports Mozilla's mission or community. | ||
* Any content related to the discussion of content on the wiki (e.g. Talk/Discussion pages). | * Any content related to the discussion of content on the wiki (e.g. Talk/Discussion pages). | ||
* Any content that is related to helping people use the Wiki. | * Any content that is related to helping people use the Wiki. | ||
Content appearing to be completely unrelated to Mozilla and not falling into any of the categories above may be deleted as spam or moved elsewhere. | Content appearing to be completely unrelated to Mozilla and not falling into any of the categories above may be deleted as spam or moved elsewhere. | ||
== Is product documentation appropriate for the Mozilla Wiki? == | |||
In general, no, product documentation is not appropriate for the Mozilla Wiki except when it is about the Mozilla Wiki itself. | |||
There are two types of product documentation: end-user documentation and developer-focused documentation. | |||
'''End-user documentation''' is written for users of Mozilla's products and explains how are products work and how to use them. In general, this type of content belongs on [http://support.mozilla.org SUMO]. | '''End-user documentation''' is written for users of Mozilla's products and explains how are products work and how to use them. In general, this type of content belongs on [http://support.mozilla.org SUMO]. | ||
'''Developer documentation''' is written for programmers | '''Developer-focused documentation''' is written for programmers and includes content such as technical reference information and building and debugging instructions. In general, this type of content belongs on [http://developer.mozilla.org MDN]. | ||
== Who own and maintains the Mozilla | To summarize: [http://developer.mozilla.org MDN] documents how to interact with code. The Mozilla wiki documents how to interact with teams. [http://support.mozilla.org SUMO] documents how to interact with Mozilla products (as an end-user). | ||
== Who own and maintains the Mozilla Wiki? == | |||
The wiki is owned and maintained by the Mozilla community. | The wiki is owned and maintained by the Mozilla community. | ||
| Line 69: | Line 70: | ||
General questions can be addressed to [https://www.mozilla.org/about/forums/#tools-wiki tools-wiki] or #wiki on irc.mozilla.org. | General questions can be addressed to [https://www.mozilla.org/about/forums/#tools-wiki tools-wiki] or #wiki on irc.mozilla.org. | ||
== How is the Wiki a critical resource to the Mozilla Project? == | |||
'''The Wiki provides the most comprehensive, overall picture of Mozilla's mission, strategy, and history.''' Information on the wiki tells the story of Mozilla and makes the organization navigable in a way that no other single resource does. The wiki, along with [https://bugzilla.mozilla.org Bugzilla] and our [https://www.mozilla.org/about/forums/ forums], form the core of Mozilla's long-term institutional record. | |||
'''The Wiki is a significant entry point for contributors into the Mozilla project.''' It serves as a primary and massively scalable on-boarding tool because it provides the opportunity for self-serve contribution pathways across all areas of the project. The wiki enables self-motivated individuals to take advantage of contribution opportunities immediately. The better organized the wiki, the more people are able to take advantage of these opportunities. | |||
'''Publicly available wikis, code repositories, and bug trackers are essential to our collaborative environment and connect our project to the greater open source eco-system.''' These tools are part of the established canon of open source organizational tools because they make the knowledge and tools required to participate immediately available to those who are interested. Experienced open source participants benefit from Mozilla providing these tools because it is what they are accustomed to, and those new to open source benefit because it prepares them for working with other projects in the open source ecosystem. | |||
= Comments = | = Comments = | ||
| Line 86: | Line 95: | ||
: Good question. Both of the pages you link to seem fine for the Mozilla Wiki. Web Compatibility is a Mozilla project and those pages document how to contribute to it. As I'm responding to this, I'm realizing that the section distinguishing what content belongs on MDN and what belongs on Mozilla Wiki needs further work. Do others have a good way to describe the delineation between the technical information that should go on MDN vs Mozilla Wiki? [[User:Ckoehler|Christie Koehler (ckoehler)]] ([[User talk:Ckoehler|talk]]) 16:52, 9 May 2014 (PDT) | : Good question. Both of the pages you link to seem fine for the Mozilla Wiki. Web Compatibility is a Mozilla project and those pages document how to contribute to it. As I'm responding to this, I'm realizing that the section distinguishing what content belongs on MDN and what belongs on Mozilla Wiki needs further work. Do others have a good way to describe the delineation between the technical information that should go on MDN vs Mozilla Wiki? [[User:Ckoehler|Christie Koehler (ckoehler)]] ([[User talk:Ckoehler|talk]]) 16:52, 9 May 2014 (PDT) | ||
: Developer documentation can be confusing to think about because it's both produced and consumed by developers. In short, product documentation goes on MDN; process documentation goes on the wiki. In open source, the source code is part of the product, so things like building and debugging instructions are product documentation. Process documentation includes things like product plans and roadmaps, team meeting notes, bugzilla workflows, etc. Another way to think about it: MDN documents how to interact with code; the wiki documents how to interact with teams. For Karl's examples, I'd say that the Guide is a process doc (people interaction) and the Updating doc is a product doc (code interaction) that would go under the Mozilla Build section on MDN. [[User:Jswisher|Jswisher]] ([[User talk:Jswisher|talk]]) 10:23, 14 May 2014 (PDT) | |||
'''About WikiMo''': The about page says currently "Governance issues are managed by the WikiMo module, a sub-module of Websites." but it doesn't explain what is WikiMo and the link goes to a table which is not really about Governance. Is there a more appropriate place on the wiki or elsewhere? [[User:Karlcow|Karlcow]] ([[User talk:Karlcow|talk]]) 15:46, 9 May 2014 (PDT) | '''About WikiMo''': The about page says currently "Governance issues are managed by the WikiMo module, a sub-module of Websites." but it doesn't explain what is WikiMo and the link goes to a table which is not really about Governance. Is there a more appropriate place on the wiki or elsewhere? [[User:Karlcow|Karlcow]] ([[User talk:Karlcow|talk]]) 15:46, 9 May 2014 (PDT) | ||
| Line 122: | Line 133: | ||
[[User:Gerv|Gerv]] ([[User talk:Gerv|talk]]) 05:51, 13 May 2014 (PDT) | [[User:Gerv|Gerv]] ([[User talk:Gerv|talk]]) 05:51, 13 May 2014 (PDT) | ||
: -- I think Gerv's distinction is really spot on: dynamic(wikimo) vs static (mdn) but both long-term-relevant. This is very important because the line between documentation in general and documentation for (new) contributors for a specific team is really thin, IMO. So the criteria dynamic and long-term-relevant seem a good way to guide the user in deciding. (The two cents of a new contributor who fought a bit to navigate the mare magnum of mozilla's documentation on contributing :)) | |||
[[User:Madamezou|Madamezou]] ([[User talk:Madamezou|talk]]) 09:05, 18 May 2014 (PDT) | |||
'''Joelle's comments:''' Does the About page need to be written in a specific tone or language? As a new contributor to WikiMo, the Purpose and How is the Wiki… statements still seem a bit opaque and removed. I wonder if we can incorporate the language used in Wiki Working Group meetings into this About. Last Wiki Working Group meeting the wiki was described as "the innards" of an organization. That term clarified a few questions I had about the scope of WikiMo. It implies what is already stated on the About page in a more inviting way: that the Wiki is a publicly available internal platform; that it makes public information neither designed nor intended for end-users. While I understand that "innards" might not connote the same meaning for some readers, can we consider a tone that is more inviting, yet pithy? | |||
[[User:Jo as Queeniebee|Jo as Queeniebee]] ([[User talk:Jo as Queeniebee|talk]]) 17:02, 13 May 2014 (PDT) | |||
'''Tristan's comments:'''Very happy to see some effort put into the Wiki! I agree with its central role as a tool for participation and memory of the project along with Bugzilla. Nothing to add at this point but will do if anything comes up. Keep up the good work! [[User:Tnitot|Tnitot]] ([[User talk:Tnitot|talk]]) 02:58, 14 May 2014 (PDT) | |||
'''Mitchell's comments:''' I echo the appreciation for taking on these topics. I have a couple of questions. First, I wonder if the two purposes are complementary or at odds with each other. One is to the encyclopedia reference, the other is to facilitate interaction. I can imagine both working well if there is very clear separation and wiki-care. There's probably some development of good practices and some sustaining grass-roots encouragement of a good separation of these two activities as well. You may well already have thoughts about this, so I'll stop here. | |||
Secondly, it would also help me to get a clear picture of how the wiki relates to other workflows and results. Right now teams use a whole variety of tools to collaborate. I'll give a few examples here. The goal isn't to be picky; it's to give an idea of the kinds of questions I can see developing. If a team uses etherpads or google docs for example, how do we think about the relationship of that output to the wiki? If we have an official blog post, how does that relate to the wiki? A very specific example -- we just made statements about DRM and our products in the Mozilla blog. Would someone add something to wikiMO to point to that content? or copy it in the wiki? or is that kind of content outside the scope? | |||
And on a related note, are you thinking people will maintain wikiMO as a resource, or more of asking Mozillians to use the wiki as a workplace to create the encyclopedia? | |||
<>[[User:MitchellBaker|mitchell@mozilla.org]] ([[User talk:MitchellBaker|talk]]) 22:43, 20 May 2014 (PDT)</> | |||