m (PesachZ moved page User:PesachZ/Wazeopedia to waze:Wazeopedia) |
Kentsmith9 (talk | contribs) m (removed construction template) |
||
(13 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
'''Wazeopedia''' is the new name for the Waze community wiki, and also the project name for converting the prior wikis into the new framework. First [http://www.waze.com/forum/viewtopic.php?f=276&t=123270 announced in Jan, 2015], the project is led by {{username|WonderLerm}}, a member of Waze staff. Wazeopedia contains unique individual wiki instances for each local community, as well as another instance to host global content. Content will be able to shared across the wikis, maintaining the collaboration while allowing the reader an insulated experience. | |||
'''Wazeopedia''' is the new name for the Waze community wiki, and also the project name for converting the | |||
== Framework == | == Framework == | ||
Wazeopedia is separated into a group of sister wikis. These individual wikis will function on their own, yet also be able to share resources with each other. | |||
The individual wikis inside Wazeopedia | The individual wikis inside Wazeopedia are structured as follows: | ||
* A [[#Global wiki|'''Global wiki''']] containing content that is valid everywhere, and not subject to local variation. This includes interface guides, global rules, and best practices, etc. | * A [[#Global wiki|'''Global wiki''']] containing content that is valid everywhere, and not subject to local variation. This includes interface guides, global rules, and best practices, etc. | ||
** A '''Commons wiki''' | ** A '''Commons wiki''' hosts a repository of images and other resources which are easily accessed by any of the other wikis. This will prevent a lot of duplication of the same resources for each wiki. | ||
* A separate [[#Local wiki|'''Local wiki''']] for each country / local community which wishes to have its own wiki, representing their unique guidance. | * A separate [[#Local wiki|'''Local wiki''']] for each country / local community which wishes to have its own wiki, representing their unique guidance. | ||
Line 18: | Line 17: | ||
{{Mbox|type=critical|text={{Red|'''DO NOT EDIT''' ANY GLOBAL PAGE WITHOUT '''PRIOR GLOBAL CONSENSUS'''.}} Please make sure you follow the [[#Protocol for editing global pages|protocol for editing global pages]], as well as the [[Waze_etiquette#Wiki_changes|Waze wiki editing etiquette]]}} | {{Mbox|type=critical|text={{Red|'''DO NOT EDIT''' ANY GLOBAL PAGE WITHOUT '''PRIOR GLOBAL CONSENSUS'''.}} Please make sure you follow the [[#Protocol for editing global pages|protocol for editing global pages]], as well as the [[Waze_etiquette#Wiki_changes|Waze wiki editing etiquette]]}} | ||
[[File:Wazeopedia.png|right]]The Wazeopedia Global wiki | [[File:Wazeopedia.png|right]]The Wazeopedia Global wiki is built from carefully selected content that is useful for all the local Waze editing communities around the world. Each local community is free to include global content into its own pages. This can be done in the original English, or by creating a modified, translated, or interpreted derivative page in their own local wiki. | ||
Since the Global wiki pages may be reused by any community, it is imperative that they maintain a Global perspective, and reflect global consensus. Therefore any edits to a Global wiki page must follow the [[#Protocol for editing global pages|protocol for editing global pages]], as well as the [[Waze_etiquette#Wiki_changes|Waze wiki editing etiquette]]. | Since the Global wiki pages may be reused by any community, it is imperative that they maintain a Global perspective, and reflect global consensus. Therefore any edits to a Global wiki page must follow the [[#Protocol for editing global pages|protocol for editing global pages]], as well as the [[Waze_etiquette#Wiki_changes|Waze wiki editing etiquette]]. | ||
Line 25: | Line 24: | ||
<!-- | |||
*************************************************************** | |||
The following sections are held here in the comments for historical purposes | |||
*************************************************************** | |||
=== Nominated pages for global wiki === | === Nominated pages for global wiki === | ||
Line 34: | Line 37: | ||
While a great deal of effort has been extended to build an accurate inventory of existing wiki pages which have global relevance, mistakes are inevitable. The people parsing the pages to determine if they are globally relevant, are usually not the authors of the page, and may not even be familiar with discussions about the page. It is entirely possibly for a page which was only ever intended for a local community audience to be nominated for the global wiki, or for a page intended for a global audience to have been missed and not be nominated. | While a great deal of effort has been extended to build an accurate inventory of existing wiki pages which have global relevance, mistakes are inevitable. The people parsing the pages to determine if they are globally relevant, are usually not the authors of the page, and may not even be familiar with discussions about the page. It is entirely possibly for a page which was only ever intended for a local community audience to be nominated for the global wiki, or for a page intended for a global audience to have been missed and not be nominated. | ||
To provide feedback and discuss a page which either; you think should have been nominated for the Global wiki, or a page which has been nominated for the Global wiki process that applies to existing pages, | To provide feedback and discuss a page which either; you think should have been nominated for the Global wiki, or a page which has been nominated for the Global wiki process that applies to existing pages, please visit [//www.waze.com/forum/viewtopic.php?t=146145 this forum thread]. You can ask questions there, and alert the global wiki team to any concerns you have. | ||
==== Inventory list of global nominees ==== | ==== Inventory list of global nominees ==== | ||
The complete list of current pages | The complete list of current pages nominated for global Wazeopedia can be viewed either on the list for [[: Category:Wazeopedia Global Page]], or in this [http://docs.google.com/spreadsheets/d/1bwS_VWdZj116-urzl7bJl7woU4SEUOzmvpPLbF5XuGA Google Sheet]. | ||
=== Page style and location === | === Page style and location === | ||
Line 52: | Line 55: | ||
*Wazeopedia for wiki admin}} | *Wazeopedia for wiki admin}} | ||
--> | |||
==== Nuggets ==== | ==== Nuggets ==== | ||
Line 74: | Line 77: | ||
To then transclude (display) this nugget in the main parent page you would use the code <code | To then transclude (display) this nugget in the main parent page you would use the code <code>{{Tl|/<Nugget title1>|nl}}</code>. You don't need to specify the parent page in the code since you're transcluding a subpage of the page you're on. | ||
''If you want to transclude (display) a Nugget from a different page, you will have to use the full page name, and if the page is in the main namespace it must be preceded by a colon (:). For example this page transcludes the wiki etiquette Nugget from the [[Waze etiquette]] page using the code | ''If you want to transclude (display) a Nugget from a different page, you will have to use the full page name, and if the page is in the main namespace it must be preceded by a colon (:). For example this page transcludes the wiki etiquette Nugget from the [[Waze etiquette]] page using the code {{tlx|:Waze etiquette#Wiki changes}}.'' | ||
===== Cautions and pitfalls of using nuggets ===== | ===== Cautions and pitfalls of using nuggets ===== | ||
Line 88: | Line 91: | ||
* Similarly an equals sign ({{=}}) is used as an operator in templates, and parser functions. You may use the {{tl|{{=}}}} [[template:{{=}}|template]] to display and {{=}} which is not an operator. This is commonly needed in deep URL links. ''For more complex usages please see the [[template:{{=}}|template documentation]].'' | * Similarly an equals sign ({{=}}) is used as an operator in templates, and parser functions. You may use the {{tl|{{=}}}} [[template:{{=}}|template]] to display and {{=}} which is not an operator. This is commonly needed in deep URL links. ''For more complex usages please see the [[template:{{=}}|template documentation]].'' | ||
<!-- | |||
*************************************************************** | |||
The following sections are held here in the comments for historical purposes | |||
*************************************************************** | |||
=== Converting from the existing wiki === | === Converting from the existing wiki === | ||
Line 99: | Line 106: | ||
--> | |||
=== Protocol for editing global pages === | === Protocol for editing global pages === | ||
Line 124: | Line 132: | ||
==== Protocol flowchart ==== | ==== Protocol flowchart ==== | ||
<center><table style="border: 1px solid #CCCCCC; font-size: small;text-align: center;"><tr><td><table style="border: 1px solid #CCCCCC;"><tr><td>[[File:Global_Wiki_Change_Control_-_process_flow.png|300px|center|link=https://wiki.waze.com/wiki/images/3/33/Global_Wiki_Change_Control_-_process_flow.png]]</td></tr></table>Click on this thumbnail to enlarge</td></tr></table></center> | |||
==== Enforcement ==== | ==== Enforcement ==== | ||
Line 134: | Line 141: | ||
== Local wiki == | == Local wiki == | ||
Editors in the US are expected to follow the USA wiki and not the global wiki. The US local Wiki continues to be managed by the US editing community as before the Wazeopedia project began. If you would like to participate, please join us in the [https://www.waze.com/forum/viewforum.php?f=1636 US Wiki forums]. |
Latest revision as of 01:06, 22 May 2017
Wazeopedia is the new name for the Waze community wiki, and also the project name for converting the prior wikis into the new framework. First announced in Jan, 2015, the project is led by WonderLerm (PM [Help]) , a member of Waze staff. Wazeopedia contains unique individual wiki instances for each local community, as well as another instance to host global content. Content will be able to shared across the wikis, maintaining the collaboration while allowing the reader an insulated experience.
Framework
Wazeopedia is separated into a group of sister wikis. These individual wikis will function on their own, yet also be able to share resources with each other.
The individual wikis inside Wazeopedia are structured as follows:
- A Global wiki containing content that is valid everywhere, and not subject to local variation. This includes interface guides, global rules, and best practices, etc.
- A Commons wiki hosts a repository of images and other resources which are easily accessed by any of the other wikis. This will prevent a lot of duplication of the same resources for each wiki.
- A separate Local wiki for each country / local community which wishes to have its own wiki, representing their unique guidance.
Global wiki
![]() |
DO NOT EDIT ANY GLOBAL PAGE WITHOUT PRIOR GLOBAL CONSENSUS. Please make sure you follow the protocol for editing global pages, as well as the Waze wiki editing etiquette |
![](https://storage.googleapis.com/wazeopedia-stg-images/7/79/Wazeopedia.png)
The Wazeopedia Global wiki is built from carefully selected content that is useful for all the local Waze editing communities around the world. Each local community is free to include global content into its own pages. This can be done in the original English, or by creating a modified, translated, or interpreted derivative page in their own local wiki.
Since the Global wiki pages may be reused by any community, it is imperative that they maintain a Global perspective, and reflect global consensus. Therefore any edits to a Global wiki page must follow the protocol for editing global pages, as well as the Waze wiki editing etiquette.
All content in the Wazopedia Global wiki will be verified and maintained for accuracy by a combined group of Wiki Masters and Champs, with assistance from staff. The Champs will also ensure the content is relevant to the global community and not biased to only certain local communities.
s://www.waze.com/forum/memberlist.php?mode=group&g=145 Wiki Masters team] which has been tasked with building the new Wazeopedia has examined the pages in the existing Waze wiki, and nominated a comprehensive list of pages which were already global in nature to be included in the Wazeopedia Global wiki.
Each page which has been nominated for the Global wiki will have the {{GlobalMark}} template placed at the top to clearly identify it to the reader as a Global nominee.
While a great deal of effort has been extended to build an accurate inventory of existing wiki pages which have global relevance, mistakes are inevitable. The people parsing the pages to determine if they are globally relevant, are usually not the authors of the page, and may not even be familiar with discussions about the page. It is entirely possibly for a page which was only ever intended for a local community audience to be nominated for the global wiki, or for a page intended for a global audience to have been missed and not be nominated.
To provide feedback and discuss a page which either; you think should have been nominated for the Global wiki, or a page which has been nominated for the Global wiki process that applies to existing pages, please visit this forum thread. You can ask questions there, and alert the global wiki team to any concerns you have.
Inventory list of global nominees
The complete list of current pages nominated for global Wazeopedia can be viewed either on the list for Category:Wazeopedia Global Page, or in this Google Sheet.
Page style and location
Choosing a namespace
![]() |
|
-->
Nuggets
Pages in the Global wiki are designed to be reused in whole or in part by the local wikis. Some local communities may wish to use only portions of a page, and fill in the rest with local guidance, or interpretation. Some portions of a page may not be relevant to certain local communities. To enable other pages, and Local wikis to easily transclude, or translate only selected portions of a page, Global wiki pages are broken down into smaller individual pieces. We refer to these smaller pieces of knowledge as nuggets.
When viewing the global page a user will see a seamless flow of content, with all the Nuggets displayed together. When building a local wiki page, the local community may choose to utilize some of the global content. In such a case the local editor could string together some of the global Nuggets with some locally generated content, and display it as one cohesive page.
This method also allows the same small piece to be displayed on multiple pages, while only truly existing in one source location. This makes maintaining the content accuracy easier, since when it changes, it only has to be updated in one place.
Using Nuggets for the content will also help efforts for those who are translating the content into other languages for the local wikis. When the global page is updated, the Local Wiki Masters won't have to study the entire page to update the translation. They will only need to update the translation of that individual nugget. Additionally with the introduction of new tools to track when a translation is outdated, the system will be able to automatically indicate to a reader which section of page (based on which nugget) is now out of date.
Process for creating nuggets
Each nugget should be a distinct small piece of knowledge content. It should be a whole thought, able to be read alone. It doesn't need to explain an entire topic but should be one full distinct aspect of the topic. A Nugget might be the contents of one section of a wiki page as a good rule of thumb. You may even split one section into a few Nuggets depending on the content.
Each Nugget should be saved as a separate subpage to the parent page it will be primarily displayed on. Each Nugget subpage should be named with a descriptive but short title. For example a nugget going to be used on this page (Wazeopedia:Wazeopedia
) should be save as Wazeopedia:Wazeopedia/<Nugget title1>
.
To then transclude (display) this nugget in the main parent page you would use the code {{[[:Template:/<Nugget title1>|/<Nugget title1>]]}}
. You don't need to specify the parent page in the code since you're transcluding a subpage of the page you're on.
If you want to transclude (display) a Nugget from a different page, you will have to use the full page name, and if the page is in the main namespace it must be preceded by a colon (:). For example this page transcludes the wiki etiquette Nugget from the Waze etiquette page using the code {{[[::Waze etiquette#Wiki changes|:Waze etiquette#Wiki changes]]}}
.
Cautions and pitfalls of using nuggets
Nuggets are designed to be transcluded (displayed) on other pages primarily, they must therefore be coded with transclusion in mind to ensure they display as desired when viewed directly and from other pages using them.
Because Nuggets are being transcluded, they follow the same rules as templates do, and have some of the same cautions.
- A pipe character (|) is used in template wiki markup code to define a new parameter in the template. When transcluded these can interfere with the parsing and cause unexpected output.
- Similarly an equals sign (=) is used as an operator in templates, and parser functions. You may use the {{=}} template to display and = which is not an operator. This is commonly needed in deep URL links. For more complex usages please see the template documentation.
Protocol for editing global pages
Any edit to the wiki should follow the rules of Waze wiki editing etiquette, edits to the Global wiki must also follow this protocol.
Purpose
The purpose of the protocol is to protect the global wiki from premature changes, or changes which do not represent a Global consensus. Because these pages may be transcluded into numerous other local wikis, and because there may be local translations of the pages which are monitoring these pages for any updates, it is very important that any changes to these pages are perfected before they are published.
The protocol summarized
- Any edit which changes the meaning of the existing content - even if the change is just a clarification compliant with the original intent of the authors - must first be presented in the forum.
- Simple edits which do not change the content meaning at all (e.g. punctuation, simple typos, removing the 's' from https URLs) do not need to be posted to the forum. These should be explained in the edit summary.
- Every edit must be based on a previous consensus posted in the public Wiki Updates and Discussion forum.
- Edits based on a private consensus (because the information used to reach the decision is proprietary, or the decision is made by Champs to protect the maps / wiki), should still first be publicly announced in the wiki updates forum, to allow the public to provide feedback. This feedback can provide an alternate perspective, or inform the private audience of special situations they had not considered. The private audience (Champs, Wiki Masters) may choose to consider this feedback, and use it to refine or adapt their consensus. Ultimately it is the decision of the Champs whether to modify their decision based on the feedback, or to move forward and publish their edit.
- After a consensus is reached (in private or public), and a resulting edit is being made, there should be an announcement in the public forum. The forum post should summarize the consensus which was reached, and describe the edit being made. This also lets others know that a guideline, interface fact, or statement, etc., is being changed.
- Simple edits which are made to clarify a pages meaning so it more clearly reflects a previously achieved consensus, should still be announced with the rationale in the forum as well. However since there is already consensus for their meaning, they don't need to wait to build consensus again. They can make the change as soon as they announce it.
- Edits which alter formatting, deal with and affect templates, might break tranclusions, or links, or otherwise affect the technical integrity of a page should be tested in a user page first, and generally should include oversight from "technical Wiki Masters".
Protocol flowchart
|
Enforcement
There is a team of Wiki Moderators who will patrol the Global wiki pages and ensure that any changes which are made have followed this protocol. In the new Wazopedia changes will not be visible to regular users until after the moderators approve them. In the current wiki until the upgrade to Wazeopedia is completed the moderators will monitor pages nominated for the Global wiki, and may have to revert changes which don't follow this protocol, until they conform to this protocol.
If an edit is made which does not follow this protocol, the moderators will hold the edit until it is agreed upon using this protocol. The moderators will begin a discussion in the proper forum to facilitate this process if the editor failed to so first.
Local wiki
Editors in the US are expected to follow the USA wiki and not the global wiki. The US local Wiki continues to be managed by the US editing community as before the Wazeopedia project began. If you would like to participate, please join us in the US Wiki forums.