Wazeopedia:Wazeopedia: Difference between revisions View history

Line 71: Line 71:
** Simple edits which do not change the content meaning at all (e.g. punctuation, simple typos, removing the 's' from http'''s''' URLs) do not need to be posted to the forum. These should be explained in the edit summary.
** Simple edits which do not change the content meaning at all (e.g. punctuation, simple typos, removing the 's' from http'''s''' 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 [http://www.waze.com/forum/viewforum.php?f=276 Wiki Updates and Discussion] forum.
* Every edit must be based on a previous consensus posted in the public [http://www.waze.com/forum/viewforum.php?f=276 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)'', should still first be publicly announced in the wiki updates forum, to allow the public to provide feedback.
 
* After a consensus is reachedc(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 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".


==== Enforcement ====
==== Enforcement ====

Revision as of 05:47, 18 June 2015

Wazeopedia is the new name for the Waze community wiki, and also the project name for converting the existing wiki into the new framework. First announced in Jan, 2015, the project is being spearheaded by wonderlerm (PM [Help])   a member of Waze staff. Wazeopedia will contain a unique individual wiki instance 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 a insulated experience.


Framework

The Wazeopedia will be 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 will be 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 will host a repository of images and other resources which may be easily used 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

The Wazeopedia Global wiki will be built of 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.

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.


Converting from the existing wiki

As of June 2015 the Wazeopedia Global wiki site is not yet available. However, the Wiki Masters team which has been tasked with building the new Wazeopedia 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. They are currently editing all these pages to meet the standards of the Wazeopedia Global wiki. This is a slow process, as there is a great deal of content to work on.


The majority of these pages which have been nominated for the Wazeopedia Global wiki were heavily biased to the United States, and some other English-speaking local communities. This is because most of the English content wiki was primarily edited by American editors. As part of the preparation for, and the conversion process to move these pages to the Wazeopedia Global wiki, they will have to "globalized". To "globalize" a page the Wiki Masters working with the Global Champs will remove any information specific to the local communities, and replace it with globally relevant information instead.

These local communities will have to decide if they want to either maintain the current page as is, or adopt the new global version for their local community as well.

If they want to maintain the original page, the Wiki Master team will offer to work in tandem with the local editors to make a copy for them before any "globalization" is performed. The local editors may choose to make the copy and separate it from the global page on their own.


Nominated pages for global wiki

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, pease visit this forum thread. You can ask questions there, and alert the global wiki team to any concerns you have.

need to find a proper forum link


Inventory list of global nominees

The complete list of current pages nomininated for global Wazeopedia can be viewed either on the list for Category:Wazeopedia Global Page, or in this Google Sheet.


Protocol for editing global pages

protocol chart
define moderator role and outline protocol

Any edit to the wiki should follow the rules Waze wiki editing etiquette, edits to the Global wiki must also follow this protocol.

Click expand to read the Waze wiki editing etiquette
  • Any controversial or mapping guideline change should be brought up in the forum before making it in the Wiki. Once a consensus is reached, the change can be made. If a controversial change is made without following this guideline that change should be reverted until it is approved through this process.
  • All content in the Wiki shall not use any words or language that would be considered degrading, demeaning, condescending, or otherwise uncivil.
  • All discussions around edits and changes in forums and private messages will be made in a civil, non-confrontational manner. Words can be misinterpreted so always assume good faith in their definitions and true purpose before assuming otherwise.
  • Waze Wiki pages generally contain guidance and information for other users and editors. Be sure to identify information that may be speculation or inference. Avoid pure opinion with no evidence. Avoid discussions of desired operation, which should only go into the appropriate forums.
  • Do not place questions in the Wiki without discussion in the Wiki Updates forum first.
  • Do not create pages outside the scope of Waze operation or products.
  • Before creating a new page in the Main Wiki namespace, consider creating a page in your own user namespace and then offer up the content in the forum to be considered. There are times when similar pages or content already exist and this prevents multiple pages with the same content making maintenance of the Wiki much more difficult.
  • If another editor makes a recommendation about a change you made in the Wiki, at least consider the suggestion. It is possible their experience may exceed your own, or it may not. When it cannot be resolved, bring the concern to the forum for further discussion to get other input.
  • Do not blank or delete all content from a page you did not create without discussing it in the forums or with the original page creator.
  • Now that the Wazeopedia project is released and the USA has a dedicated wiki, the spelling on the USA wiki will be based on US English spelling variations.
  • Any editors who continue to violate any of these etiquette recommendations will be subject to a minimum 24-hour banning from editing in the Wiki. Continued violators will be subject to longer bans.
This list is also presented in the Waze forums.

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 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 changs 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), should still first be publicly announced in the wiki updates forum, to allow the public to provide feedback.
  • After a consensus is reachedc(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 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".

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, until then the moderators may have to revert changes which are made 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

explain purpose of local wiki, content management authority and responsibility, WM tools