Template:Locking Standard/doc View history

m (added {{doc subpage}})
m (Kartografer moved page User:Kartografer/Locking Standard/doc to Template:Locking Standard/doc: moving template documentation)
Tag: national guidance change
 
(42 intermediate revisions by 3 users not shown)
Line 2: Line 2:
This template builds a preformatted table complete with explanatory text above, (and optionally below,) to list the segment locking standards for a state or region.
This template builds a preformatted table complete with explanatory text above, (and optionally below,) to list the segment locking standards for a state or region.


{{Mbox|type=critical|text={{red|Do not change any of the default lock ranks in the template}} without first getting national consensus in the forum, and notifying the Regional Coordinator of every state using the template to display the default value for that road type on their states pages.}}


===Supporting tools===
===Supporting tools===
Line 17: Line 18:
Many of the features are optional and displayed only if their parameters are set. The table caption is in bold text. The rows of the table have an alternating light Waze blue background highlight. The road types are displayed using their colors as represented in WME.
Many of the features are optional and displayed only if their parameters are set. The table caption is in bold text. The rows of the table have an alternating light Waze blue background highlight. The road types are displayed using their colors as represented in WME.


The table is built with default lock rank values which may change based upon general consensus. All the lock ranks are customizable except for RailRoads (set to 2 by Waze staff nationally), and Ferries (which are limited to very specialized use if used at all, and therefore are set to 5).
The table is built with default lock rank values which may change based upon general consensus. All the lock ranks are customizable except for railroads (set to 2 by Waze staff nationally).
The table can list different locks for up to three regions within a single state. If multiple regions are enabled in your table you don't need to repeat the lock ranks for each column, unless they deviate from the first column. Therefore if your second region only had a different rank for MH, you only need to specify the rank of MH in region 2, the rest of region 2 road type will use the same rank values as region one.
The table can list different locks for up to three regions within a single state. If multiple regions are enabled in your table you don't need to repeat the lock ranks for each column, unless they deviate from the first column. Therefore if your second region only had a different rank for MH, you only need to specify the rank of MH in region 2, the rest of region 2 road type will use the same rank values as region one.  
 
The table is designed to merge adjacent cells on the same row which have the identical lock ranks. Whether they are identical because they were set the same, or because they default to be the same, if the output is going to be the same, they will be merged into one cell using a <code>colspan=n</code>.


===Samples===
===Samples===
A complex output displaying all possible elements:
A complex output displaying all possible elements:
{{Mbox|image=none|text={{Locking Standard|title2=2nd Region|title3=3rd Region|MH2=4|mH3=3|PS2=2|PS3=2|Private=3|PLR2=2|Runway=5|Ferry=2|Other=1|Construction=3|Beacon2=Waze Staff|Beacon3=6|note=This table uses all elements available.|append=Some of the elements featured in this table are using the defaults and are not customized.}}}}


{{Locking Standard|title2=2nd Region|title3=3rd Region|MH2=4|mH3=3|PS2=2|PS3=2|Private=3|PLR2=2|note=This table uses all elements available.|append=Some of the elements featured in this table are using the defaults and are not customized.}}
----
A simple output displaying the fewest possible elements:
A simple output displaying the fewest possible elements:
 
{{Mbox|image=none|text={{Locking Standard|lede=|caption=&nbsp;}}}}
{{Locking Standard|lede=|caption=}}




Line 38: Line 37:




{{Para|lede}} This is the lede paragraph, the paragraph of text displayed above the table.
{{Para|lede}} This is the '''lede paragraph''', the paragraph of text displayed above the table.
*If you do not want to have a lede paragraph, make sure to set this parameter to a blank value like this; {{para|lede|{{!}}}}.
*If you do not want to have a lede paragraph, make sure to set this parameter to a blank value like this; {{para|lede|{{!}}}}
*If this parameter is not set, the following default text will be used:
*If this parameter is not set, the following '''default text''' will be used:
{{Mbox|image=none|text=In {{RootPage2}} we have a set minimum standard for locking roads based on segment type. Any road of a certain segment type must be locked '''at least''' to the rank (level) in the chart below. Roads may be locked higher for protection and special situations (areas with construction, tricky design, frequent mistakes, imaging inaccuracies, and the like), but should not be locked lower.<br />
{{Mbox|image=none|text=In {{RootPage2}} we have a set minimum standard for locking roads based on segment type. Any road of a certain segment type must be locked '''at least''' to the rank (level) in the chart below. Roads may be locked higher for protection and special situations (areas with construction, tricky design, frequent mistakes, imaging inaccuracies, and the like), but should not be locked lower.
<br />
 
A great time to implement these locks is while performing the FC Upgrade of an area. Lock the roads based on type after they've been set to FC standards.}}
A great time to implement these locks is while performing the FC Upgrade of an area. Lock the roads based on type after they've been set to FC standards.}}
:''NOTICE how it starts off "In {{u|Locking Standard}} we have set...", this uses the name of the root page the template will ultimately be displayed on. If you are using it in one of the USA state wiki pages this will show the states name, even if it is on a subpage of that state.''
:''NOTICE how it starts off "In {{u|Locking Standard}} we have set...", this uses the name of the root page the template will ultimately be displayed on. If you are using it in one of the USA state wiki pages this will show the states name, even if it is on a subpage of that state.''
{{Para|caption}} This sets the caption displayed in bold text above the table.
 
*If you do not want to have a caption, make sure to set this parameter to a blank value like this; {{para|caption|{{!}}}}.
{{Para|caption}} This sets the '''caption''' displayed in bold text above the table.
*If parameter is not set, the following default text will be used:
*If you do not want to have a caption, make sure to set this parameter to a blank value like this; {{para|caption|{{&}}nbsp;}}
*If parameter is not set, the following '''default text''' will be used:
{{Mbox|image=none|text='''<center><State> Minimum Locking Rank Standard</center>'''}}
{{Mbox|image=none|text='''<center><State> Minimum Locking Rank Standard</center>'''}}
:''"<State>" in the default caption will use the same root page name as the default lede text.
:''"<State>" in the default caption will use the same root page name as the default lede text.
{{para|title}} The title of the first column of lock values (sometimes the only column).
 
*If the parameter is not set (if it is omitted), the default title "Default locks" is used.
{{para|title}} The title of the '''first column''' of lock values (sometimes the only column).
{{Para|title2}} This is the column title for the second regional column.
*If the parameter is not set (if it is omitted), the '''default title''' "Default locks" is used.
 
{{Para|title2}} This is the column title for the '''second regional column'''.
*This parameter must be set in order for the second regional column to be displayed.
*This parameter must be set in order for the second regional column to be displayed.
*If you do not specify a title, the entire column will not appear. There is no default display.
*If you do not specify a title, the entire column will not appear. There is '''no default''' display.
{{Para|title3}} This is the column title for the third regional column.
 
{{Para|title3}} This is the column title for the '''third regional column'''.
*This parameter must be set in order for the third regional column to be displayed.
*This parameter must be set in order for the third regional column to be displayed.
*If you do not specify a title, the entire column will not appear. There is no default display.
*If you do not specify a title, the entire column will not appear. There is '''no default''' display.
 
'''Custom Lock Ranks'''
'''Custom Lock Ranks'''
*Every road type has a default lock rank which will be used by this template unless it is overridden by a custom value.
*Every road type has a default lock rank which will be used by this template unless it is overridden by a custom value.
*There are built-in defaults, these will be used in the first column (region) if you do not set the lock rank for a specific road type.
*There are built-in defaults, these will be used in the first column (region) if you do not set the lock rank for a specific road type.
*If you specify a custom rank for the first regional column, that rank will be used as the default for the remaining two columns. If an column is listed but a custom rank is not specified for the same road type, it will display the same rank as the first column.
*Each road type which allows custom lock ranks has three parameters available, one for each column. The first parameter name is the abbreviation for that road type, the next 2 are the abbreviation followed by a "2" or "3".
*''{{As of|2018|Dec}} the Railroad type has a hard-coded lock ranks value which cannot be customized. For the reasoning, and to participate in the discussion see the [http://www.waze.com/forum/viewtopic.php?t=122610 forum thread].''
*The following parameters for road ranks accept any text value. It is recommended to just enter a single digit for simplicity. In some cases (Ramps for example it may be necessary to use text instead.
*Being that the default lock ranks displayed by this template may change over time, it is recommended to define the lock ranks for your region and not rely on the default values. If you set the first column thiugh, that becomes the default for the remaining columns in the table, and its OK not to list identical ranks for the same road type in different regions.
{{Para|Fwy}} This sets the displayed lock rank for {{Freeway}} in the first column.
*If the second (and third) column are displayed but they do not have a custom rank set for freeways, they will also use this rank.
*If this parameter is not set to a custom rank, it will show rank '''"4"'''.
{{Para|Fwy2}} This sets the lock rank for Freeway in the second displayed region.
*If this parameter is not set, it will show the same rank as the first column.
*This rank will only be displayed in the table if the second regional column is activated. (The second column is activated by setting a header for it using the {{para|title2}} parameter mentioned above.
{{para|Fwy3}} This functions the same as {{para|Fwy2}}, but applies to the third regional column.
{{Para|Ramp}} This sets the lock rank for {{ramp|ramps}}.
*If this parameter is not set, the default text displayed will be: '''"Highest rank of connected segment"'''.
{{Para|Ramp2}} As above sets the rank for ramps in the second regional column.
{{Para|Ramp3}} As above sets the rank for ramps in the third regional column.
{{Para|MH}} Sets the lock rank for {{Major Highway}}
*If this parameter is not set, the default text displayed will be: '''"3"'''
{{Para|MH2}} Sets the second regional lock rank for MH.
{{Para|MH3}} Sets the third regional lock rank for MH.
{{Para|mH}} Sets the lock rank for {{Minor Highway}}
*If this parameter is not set, the default text displayed will be: '''"2"'''
{{Para|mH2}} Sets the second regional lock rank for mH.
{{Para|MH3}} Sets the third regional lock rank for mH.
{{Para|PS}} Sets the lock rank for {{Primary Street}}
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|PS2}} Sets the second regional lock rank for PS.
{{Para|PS3}} Sets the third regional lock rank for PS.
{{Para|Street}} Sets the lock rank for {{Street}}
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|Street2}} Sets the second regional lock rank for Street.
{{Para|Street3}} Sets the third regional lock rank for Street.
{{Para|Ferry}} Sets the lock rank for {{Ferry}}
*If this parameter is not set, the default text displayed will be: '''"5"'''
{{Para|Ferry2}} Sets the second regional lock rank for Ferry.
{{Para|Ferry3}} Sets the third regional lock rank for Ferry.
{{Para|Private}} Sets the lock rank for {{Private}}
*This row will only be displayed if at least one of the displayed columns has a custom rank set for Private Roads. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|Private2}} Sets the second regional lock rank for Private.
{{Para|Private3}} Sets the third regional lock rank for Private.
{{Para|PLR}} Sets the lock rank for {{Parking Lot Road}}
*This row will only be displayed if at least one of the displayed columns has a custom rank set for Parking Lot Roads. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|PLR2}} Sets the second regional lock rank for Parking Lot Road.
{{Para|PLR3}} Sets the third regional lock rank for Parking Lot Road.
{{Para|Runway}} Sets the lock rank for {{Runway}}
*This row will only be displayed if at least one of the displayed columns has a custom rank set for Runways. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|Runway2}} Sets the second regional lock rank for Runway.
{{Para|Runway3}} Sets the third regional lock rank for Runway.
{{Para|Other}} Sets the lock rank for any other road types.
*This row will only be displayed if at least one of the displayed columns has a custom rank set for other named types. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|Other2}} Sets the second regional lock rank for other road types.
{{Para|Other3}} Sets the third regional lock rank for other road types.
{{Para|Construction}} Sets the lock rank for segment in construction areas with oudated aerial imagery.
*This row will only be displayed if at least one of the displayed columns has a custom rank set for construction areas. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
*If this parameter is not set, the default text displayed will be: '''"1"'''
{{Para|Construction2}} Sets the second regional lock rank for construction areas.
{{Para|Construction3}} Sets the third regional lock rank for construction areas.
{{Para|Beacon}} Sets the lock rank for segments associated with installed Waze Beacons.
*This row will only be displayed if at least one of the displayed columns has a custom rank set for segments with beacons. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
*If this parameter is not set, the default text displayed will be: '''"6"'''
{{Para|Beacon2}} Sets the second regional lock rank for segments with beacons.
{{Para|Beacon3}} Sets the third regional lock rank for segments with beacons.
{{Para|note}} This adds note text below the table, when it is used the text is preceded by the word "'''NOTE:'''"
*If this parameter is not used there is '''no default''' text displayed below the table.
{{Para|append}} This adds text below the table as well, but without the word "'''NOTE:'''" preceding it.
*This can be used in conjunction with the {{para|note}} parameter to display two separate texts below the table.
*When this is used with {{para|note}}, this text will appear on a new line below the note text.
*If this parameter is not used there is '''no default''' text displayed below the table.
===Example usage===
Here is a simple display using only defaults except for eliminating the lede paragraph, changing the caption, and changing one lock level (Freeway is set to rank 5 instead of 4).
To display this table you would use the following code on your page:
{{Tlx|Locking Standard|lede{{=}}|caption{{=}}Simple Sample Locking Table|Fwy{{=}}5}}
{{Mbox|image=none|text={{Locking Standard|lede=|caption=Simple Sample Locking Table|Fwy=5}}}}
----
This complex example has three regional columns, changes many defaults, including interactions of defaults for the same type across the three columns, but does use default lede and caption; ''(Note that the caption "state name" is pulled from the template/documentation page, and is not representative of a normal configuration. When displayed on a state page it will say <State Name> minimum...)''
<code><nowiki>{{</nowiki>Locking Standard
|title =Variant 1 - Urban
|title2=Variant 2 - Rural
|title3=Variant 3 - Everywhere else
|Fwy =5  |MH=5
|Fwy2=4  |MH2=3
|MH3 =4  |mH3=2
|Ramp2=2 |Ramp3=Second highest connected segment lock
|Private=2<nowiki>}}</nowiki></code>
{{Mbox|image=none|text={{Locking Standard|title=Variant 1 - Urban|title2=Variant 2 - Rural|title3=Variant 3 - Everywhere else|Fwy=5|MH=5|Fwy2=4|MH2=3|MH3=4|mH3=2|Ramp2=2|Ramp3=Second highest connected segment lock|Private=2}}}}
----
<code><nowiki>{{</nowiki>Locking Standard
|lede=
|caption=x3 - All Default Fwy 5
|title= First Column
|title2= Second Column
|title3= Third Column
|note=This sample uses all defaults for segment lock values, but maxes out all the columns,
removes the lead-in text (lede) and adds a "note" at the end<nowiki>}}</nowiki></code>
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x3 - All Default Fwy 5
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy=5
|Fwy2=5
|Fwy3=5
|append=This sample is the same as the previous. However:
* Freeway is set to 5 instead of to 4
* All Freeway values are set to be the same manually, though the additional columns would have inherited the same value (5) anyway from the first column, i.e., the default for columns 2 and 3 is to be the same as column 1, whether column 1 inherits the ''unspecified'' default or is set to a different value. The purpose of that is to allow the caller to specify the minimal number of changes from column to column.
* The "note" is changed to the "append" parameter, which functions similarly except without the bolded "Note: " prefix
}}}}
----
<code><nowiki>{{</nowiki>Locking Standard
|lede=
|caption=x3 A=custom, B=same custom, C=default
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy=5
|Fwy2=5<nowiki>}}</nowiki></code>
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x3 A=custom, B=same custom, C=default
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy2=5
|Fwy3=5}}}}
----
<code><nowiki>{{</nowiki>Locking Standard
|lede=
|caption=x3 Region 2 & 3 Match
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy=5
|Fwy2=5
|Fwy3=3<nowiki>}}</nowiki></code>
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x3 Region 2 & 3 Match
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy2=5
|Fwy3=5
}}}}
----
<code><nowiki>{{</nowiki>Locking Standard
|lede=
|caption=x3 All Different
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy2=5
|Fwy3=3<nowiki>}}</nowiki></code>
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x3 All Different
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy2=5
|Fwy3=3
}}}}


----
----
Examples:


Simplest, using only defaults except for eliminating the lede, changing captions and changing one lock level (Freeway=5 instead of 4)
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=x3 A/C match (default C)
 
|title= First Column
 
|title2= Second Column
 
|title3= Third Column
 
|Fwy=3
 
|Fwy2=5<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x3 A/C default
|title= First Column
|title2= Second Column
|title3= Third Column
|Fwy=3
}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=x2 All Different
 
|title= First Column
 
|title2= Second Column
 
|Fwy2=5<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x2 All Default
|title= First Column
|title2= Second Column
|Fwy2=5}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=x2 Manual Match
 
|title= First Column
 
|title2= Second Column
 
|Fwy=5
 
|Fwy2=5<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x2 Manual Match
|title= First Column
|title2= Second Column
|Fwy=5
|Fwy2=5}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=x1 Default - no table params<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x1 Default - no table params}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=x1 Custom lock
 
|Fwy=5<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x1 Custom lock
|Fwy=5}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=x1 custom title and lock
 
|title= custom
 
|Fwy=5<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=x1 custom title and lock
|title= custom
|Fwy=5}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=private custom 3
 
|Private=3<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=private custom 3
|Private=3}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=private and plr
 
|Private=2
 
|PLR=1<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=private and plr
|Private=2
|PLR=1}}}}
 
 
----
 
<code><nowiki>{{</nowiki>Locking Standard
 
|lede=
 
|caption=private, plr (default 1, custom 2), runway and beacon
 
|Private=2
 
|title2=custom plr
 
|PLR2=2
 
|Runway=4
 
|Beacon=6<nowiki>}}</nowiki></code>
 
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=private, plr (default 1, custom 2), runway and beacon
|Private=2
|title2=custom plr
|PLR2=2
|Runway=4
|Beacon=6}}}}
 
 
----


<nowiki>{{Locking Standard|lede=|caption=Simple Sample Locking Table|Fwy=5}}</nowiki>
<code><nowiki>{{</nowiki>Locking Standard


{{Locking Standard|lede=|caption=Simple Sample Locking Table|Fwy=5}}
|lede=


Complex, has three columns, changes many defaults, including interactions of defaults for the same type across the three columns (but does use default lede and caption; ; note that the caption "state name" is pulled from the template/documentation page, as is not representative of a normal configuration)
|caption=custom ferry, runway, other types & construction


<nowiki>{{Locking Standard|title=Variant 1 - Urban|title2=Variant 2 - Rural|title3=Variant 3 - Everywhere else|Fwy=5|MH=5|Fwy2=4|MH2=3|MH3=4|mH3=2|ramp2=2|ramp3=second highest connected segment lock}}</nowiki>
|Ferry=2


|PLR=3


{{Locking Standard|title=Variant 1 - Urban|title2=Variant 2 - Rural|title3=Variant 3 - Everywhere else|Fwy=5|MH=5|Fwy2=4|MH2=3|MH3=4|mH3=2|ramp2=2|ramp3=second highest connected segment lock}}
|Runway=1


Supports up to three variations per state, with only one required. To add a second, make sure to specify the title for the second variant column e.g., |title2=Urban areas|. To add a third, make sure to add the title for the third variant column e.g., |title3=NYC Only|.
|Other=1


For the first variant, the defaults are 4,3,2,1,1 (Fwy,MH,mH,PS,Street), plus Ramp has the text "highest rank of connected segment," RR=2, Ferry=5. You can override individual values, no values, or all values.
|Construction=3<nowiki>}}</nowiki></code>


For the second and third columns, if you don't specify them, they take the value of the first column. That may be a value you specified, or the default value if you didn't specify one. If you wish to specify a custom value in the first column, and a default value in a different column, you can't -- you must specify both.
{{mbox|image=none|text={{Locking Standard
|lede=
|caption=custom ferry, runway, other types & construction
|Ferry=2
|PLR=3
|Runway=1
|Other=1
|Construction=3}}}}
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Transcludable pages]]
[[Category:Guideline properties]]


Parameters (exact capitalization matters):
<!-- ADD INTERWIKIS BELOW THIS LINE -->


* Fwy, Fwy2, Fwy3: The Freeway values, defaults to 4
</includeonly>
* MH, MH2, MH3: Major highway values, defaults to 3
* mH, mH2, mH3: Minor highway values, defaults to 2
* PS, Street, PS2, Street2, PS3, Street3: Primary values and Street, defaults to 1

Latest revision as of 21:30, 18 December 2018

This is a documentation subpage for Template:Locking Standard.
It contains usage information, categories and other content that is not part of the original template page.

This template builds a preformatted table complete with explanatory text above, (and optionally below,) to list the segment locking standards for a state or region.

Do not change any of the default lock ranks in the template without first getting national consensus in the forum, and notifying the Regional Coordinator of every state using the template to display the default value for that road type on their states pages.

Supporting tools

  • There is a Google Sheet which automatically generates the call to this template. It lists all the approved standards for US States. It supports up to three regions within the state as stacked columns, and doesn't provide any before or after text options. You can use the sheet to start off and add parameters from the list below as necessary.
  • {{Lock Standard State}} is a cover template which has been designed to be used in conjuction with this template as a skin. Using the {{Lock Standard State}} keeps the code on state pages using this template clean. It also limits the template being possibly broken by editors unfamiliar with the template structure.
    To use {{Lock Standard State}}, you must first understand this template, create the call to this template for the output you desire. You then place that template call code in the {{Lock Standard State}} template. Once setup you only need to put a simple template call on your states page {{Lock Standard State|XX}}.


Design

This template table was based on the USA/Northeast locking standard table, and has been modified to be flexible enough to be used everywhere.

Many of the features are optional and displayed only if their parameters are set. The table caption is in bold text. The rows of the table have an alternating light Waze blue background highlight. The road types are displayed using their colors as represented in WME.

The table is built with default lock rank values which may change based upon general consensus. All the lock ranks are customizable except for railroads (set to 2 by Waze staff nationally). The table can list different locks for up to three regions within a single state. If multiple regions are enabled in your table you don't need to repeat the lock ranks for each column, unless they deviate from the first column. Therefore if your second region only had a different rank for MH, you only need to specify the rank of MH in region 2, the rest of region 2 road type will use the same rank values as region one. The table is designed to merge adjacent cells on the same row which have the identical lock ranks. Whether they are identical because they were set the same, or because they default to be the same, if the output is going to be the same, they will be merged into one cell using a colspan=n.

Samples

A complex output displaying all possible elements:

In Locking Standard we have a set minimum standard for locking roads based on segment type. Any road of a certain segment type must be locked at least to the rank (level) in the chart below. Roads may be locked higher for protection and special situations (areas with construction, tricky design, frequent mistakes, imaging inaccuracies, and the like), but should not be locked lower.

A great time to implement these locks is while bringing the road types of an area into compliance with the current US road type standards (FC and highway systems). Lock the roads based on type after they've been set to current US road type standards.

Locking Standard Minimum Locking Rank Standard
Segment Type Default locks  2nd Region  3rd Region
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3 4 3
 Minor Highway  2 3
 Primary Street  1 2
 Street  1
 Private Road  3
 Parking Lot Road  1 2 1
 • • • • Ferry • • • •   2
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2
 ⁃     ⁃        ⁃        ⁃        ⁃ Runway ⁃        ⁃        ⁃        ⁃        ⁃  5
Other named types 1
Construction (outdated imagery) 3
Waze Beacons installed 6 Waze Staff 6
Note: This table uses all elements available.
Some of the elements featured in this table are using the defaults and are not customized.

A simple output displaying the fewest possible elements:

 
Segment Type Default locks
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2


Parameters

  • Paramters for this template can be used in any order.
  • Parameters are case-sensitive and must be entered exactly as listed here.
  • We will define the parameters here in the order in which they are displayed by the template output.


|lede= This is the lede paragraph, the paragraph of text displayed above the table.

  • If you do not want to have a lede paragraph, make sure to set this parameter to a blank value like this; |lede=|
  • If this parameter is not set, the following default text will be used:
In Locking Standard we have a set minimum standard for locking roads based on segment type. Any road of a certain segment type must be locked at least to the rank (level) in the chart below. Roads may be locked higher for protection and special situations (areas with construction, tricky design, frequent mistakes, imaging inaccuracies, and the like), but should not be locked lower. A great time to implement these locks is while performing the FC Upgrade of an area. Lock the roads based on type after they've been set to FC standards.
NOTICE how it starts off "In Locking Standard we have set...", this uses the name of the root page the template will ultimately be displayed on. If you are using it in one of the USA state wiki pages this will show the states name, even if it is on a subpage of that state.

|caption= This sets the caption displayed in bold text above the table.

  • If you do not want to have a caption, make sure to set this parameter to a blank value like this; |caption=&nbsp;
  • If parameter is not set, the following default text will be used:
<State> Minimum Locking Rank Standard
"<State>" in the default caption will use the same root page name as the default lede text.

|title= The title of the first column of lock values (sometimes the only column).

  • If the parameter is not set (if it is omitted), the default title "Default locks" is used.

|title2= This is the column title for the second regional column.

  • This parameter must be set in order for the second regional column to be displayed.
  • If you do not specify a title, the entire column will not appear. There is no default display.

|title3= This is the column title for the third regional column.

  • This parameter must be set in order for the third regional column to be displayed.
  • If you do not specify a title, the entire column will not appear. There is no default display.

Custom Lock Ranks

  • Every road type has a default lock rank which will be used by this template unless it is overridden by a custom value.
  • There are built-in defaults, these will be used in the first column (region) if you do not set the lock rank for a specific road type.
  • If you specify a custom rank for the first regional column, that rank will be used as the default for the remaining two columns. If an column is listed but a custom rank is not specified for the same road type, it will display the same rank as the first column.
  • Each road type which allows custom lock ranks has three parameters available, one for each column. The first parameter name is the abbreviation for that road type, the next 2 are the abbreviation followed by a "2" or "3".
  • As of December 2018 the Railroad type has a hard-coded lock ranks value which cannot be customized. For the reasoning, and to participate in the discussion see the forum thread.
  • The following parameters for road ranks accept any text value. It is recommended to just enter a single digit for simplicity. In some cases (Ramps for example it may be necessary to use text instead.
  • Being that the default lock ranks displayed by this template may change over time, it is recommended to define the lock ranks for your region and not rely on the default values. If you set the first column thiugh, that becomes the default for the remaining columns in the table, and its OK not to list identical ranks for the same road type in different regions.

|Fwy= This sets the displayed lock rank for  Freeway  in the first column.

  • If the second (and third) column are displayed but they do not have a custom rank set for freeways, they will also use this rank.
  • If this parameter is not set to a custom rank, it will show rank "4".

|Fwy2= This sets the lock rank for Freeway in the second displayed region.

  • If this parameter is not set, it will show the same rank as the first column.
  • This rank will only be displayed in the table if the second regional column is activated. (The second column is activated by setting a header for it using the |title2= parameter mentioned above.

|Fwy3= This functions the same as |Fwy2=, but applies to the third regional column.

|Ramp= This sets the lock rank for  ramps .

  • If this parameter is not set, the default text displayed will be: "Highest rank of connected segment".

|Ramp2= As above sets the rank for ramps in the second regional column.

|Ramp3= As above sets the rank for ramps in the third regional column.

|MH= Sets the lock rank for  Major Highway 

  • If this parameter is not set, the default text displayed will be: "3"

|MH2= Sets the second regional lock rank for MH.

|MH3= Sets the third regional lock rank for MH.

|mH= Sets the lock rank for  Minor Highway 

  • If this parameter is not set, the default text displayed will be: "2"

|mH2= Sets the second regional lock rank for mH.

|MH3= Sets the third regional lock rank for mH.

|PS= Sets the lock rank for  Primary Street 

  • If this parameter is not set, the default text displayed will be: "1"

|PS2= Sets the second regional lock rank for PS.

|PS3= Sets the third regional lock rank for PS.

|Street= Sets the lock rank for  Street 

  • If this parameter is not set, the default text displayed will be: "1"

|Street2= Sets the second regional lock rank for Street.

|Street3= Sets the third regional lock rank for Street.

|Ferry= Sets the lock rank for  • • • • Ferry • • • •  

  • If this parameter is not set, the default text displayed will be: "5"

|Ferry2= Sets the second regional lock rank for Ferry.

|Ferry3= Sets the third regional lock rank for Ferry.

|Private= Sets the lock rank for  Private Road 

  • This row will only be displayed if at least one of the displayed columns has a custom rank set for Private Roads. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
  • If this parameter is not set, the default text displayed will be: "1"

|Private2= Sets the second regional lock rank for Private.

|Private3= Sets the third regional lock rank for Private.

|PLR= Sets the lock rank for  Parking Lot Road 

  • This row will only be displayed if at least one of the displayed columns has a custom rank set for Parking Lot Roads. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
  • If this parameter is not set, the default text displayed will be: "1"

|PLR2= Sets the second regional lock rank for Parking Lot Road.

|PLR3= Sets the third regional lock rank for Parking Lot Road.

|Runway= Sets the lock rank for  ⁃     ⁃        ⁃        ⁃        ⁃ Runway ⁃        ⁃        ⁃        ⁃        ⁃ 

  • This row will only be displayed if at least one of the displayed columns has a custom rank set for Runways. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
  • If this parameter is not set, the default text displayed will be: "1"

|Runway2= Sets the second regional lock rank for Runway.

|Runway3= Sets the third regional lock rank for Runway.

|Other= Sets the lock rank for any other road types.

  • This row will only be displayed if at least one of the displayed columns has a custom rank set for other named types. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
  • If this parameter is not set, the default text displayed will be: "1"

|Other2= Sets the second regional lock rank for other road types.

|Other3= Sets the third regional lock rank for other road types.

|Construction= Sets the lock rank for segment in construction areas with oudated aerial imagery.

  • This row will only be displayed if at least one of the displayed columns has a custom rank set for construction areas. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
  • If this parameter is not set, the default text displayed will be: "1"

|Construction2= Sets the second regional lock rank for construction areas.

|Construction3= Sets the third regional lock rank for construction areas.

|Beacon= Sets the lock rank for segments associated with installed Waze Beacons.

  • This row will only be displayed if at least one of the displayed columns has a custom rank set for segments with beacons. It doesn't matter what rank it's set to, even "1", as long as it has an assigned rank.
  • If this parameter is not set, the default text displayed will be: "6"

|Beacon2= Sets the second regional lock rank for segments with beacons.

|Beacon3= Sets the third regional lock rank for segments with beacons.

|note= This adds note text below the table, when it is used the text is preceded by the word "NOTE:"

  • If this parameter is not used there is no default text displayed below the table.

|append= This adds text below the table as well, but without the word "NOTE:" preceding it.

  • This can be used in conjunction with the |note= parameter to display two separate texts below the table.
  • When this is used with |note=, this text will appear on a new line below the note text.
  • If this parameter is not used there is no default text displayed below the table.

Example usage

Here is a simple display using only defaults except for eliminating the lede paragraph, changing the caption, and changing one lock level (Freeway is set to rank 5 instead of 4).

To display this table you would use the following code on your page: {{Locking Standard|lede=|caption=Simple Sample Locking Table|Fwy=5}}

Simple Sample Locking Table
Segment Type Default locks
 Freeway  5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



This complex example has three regional columns, changes many defaults, including interactions of defaults for the same type across the three columns, but does use default lede and caption; (Note that the caption "state name" is pulled from the template/documentation page, and is not representative of a normal configuration. When displayed on a state page it will say <State Name> minimum...)

{{Locking Standard

|title =Variant 1 - Urban

|title2=Variant 2 - Rural

|title3=Variant 3 - Everywhere else

|Fwy =5 |MH=5

|Fwy2=4 |MH2=3

|MH3 =4 |mH3=2

|Ramp2=2 |Ramp3=Second highest connected segment lock

|Private=2}}

In Locking Standard we have a set minimum standard for locking roads based on segment type. Any road of a certain segment type must be locked at least to the rank (level) in the chart below. Roads may be locked higher for protection and special situations (areas with construction, tricky design, frequent mistakes, imaging inaccuracies, and the like), but should not be locked lower.

A great time to implement these locks is while bringing the road types of an area into compliance with the current US road type standards (FC and highway systems). Lock the roads based on type after they've been set to current US road type standards.

Locking Standard Minimum Locking Rank Standard
Segment Type Variant 1 - Urban  Variant 2 - Rural  Variant 3 - Everywhere else
 Freeway  5 4 5
 Ramp  Highest rank of connected segment 2 Second highest connected segment lock
 Major Highway  5 3 4
 Minor Highway  2
 Primary Street  1
 Street  1
 Private Road  2
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x3 - All Default Fwy 5

|title= First Column

|title2= Second Column

|title3= Third Column

|note=This sample uses all defaults for segment lock values, but maxes out all the columns, removes the lead-in text (lede) and adds a "note" at the end}}

x3 - All Default Fwy 5
Segment Type First Column  Second Column  Third Column
 Freeway  5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2

This sample is the same as the previous. However:

  • Freeway is set to 5 instead of to 4
  • All Freeway values are set to be the same manually, though the additional columns would have inherited the same value (5) anyway from the first column, i.e., the default for columns 2 and 3 is to be the same as column 1, whether column 1 inherits the unspecified default or is set to a different value. The purpose of that is to allow the caller to specify the minimal number of changes from column to column.
  • The "note" is changed to the "append" parameter, which functions similarly except without the bolded "Note: " prefix



{{Locking Standard

|lede=

|caption=x3 A=custom, B=same custom, C=default

|title= First Column

|title2= Second Column

|title3= Third Column

|Fwy=5

|Fwy2=5}}

x3 A=custom, B=same custom, C=default
Segment Type First Column  Second Column  Third Column
 Freeway  4 5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x3 Region 2 & 3 Match

|title= First Column

|title2= Second Column

|title3= Third Column

|Fwy=5

|Fwy2=5

|Fwy3=3}}

x3 Region 2 & 3 Match
Segment Type First Column  Second Column  Third Column
 Freeway  4 5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x3 All Different

|title= First Column

|title2= Second Column

|title3= Third Column

|Fwy2=5

|Fwy3=3}}

x3 All Different
Segment Type First Column  Second Column  Third Column
 Freeway  4 5 3
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x3 A/C match (default C)

|title= First Column

|title2= Second Column

|title3= Third Column

|Fwy=3

|Fwy2=5}}

x3 A/C default
Segment Type First Column  Second Column  Third Column
 Freeway  3
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x2 All Different

|title= First Column

|title2= Second Column

|Fwy2=5}}

x2 All Default
Segment Type First Column  Second Column
 Freeway  4 5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x2 Manual Match

|title= First Column

|title2= Second Column

|Fwy=5

|Fwy2=5}}

x2 Manual Match
Segment Type First Column  Second Column
 Freeway  5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x1 Default - no table params}}

x1 Default - no table params
Segment Type Default locks
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x1 Custom lock

|Fwy=5}}

x1 Custom lock
Segment Type Default locks
 Freeway  5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=x1 custom title and lock

|title= custom

|Fwy=5}}

x1 custom title and lock
Segment Type custom
 Freeway  5
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=private custom 3

|Private=3}}

private custom 3
Segment Type Default locks
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 Private Road  3
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=private and plr

|Private=2

|PLR=1}}

private and plr
Segment Type Default locks
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 Private Road  2
 Parking Lot Road  1
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2



{{Locking Standard

|lede=

|caption=private, plr (default 1, custom 2), runway and beacon

|Private=2

|title2=custom plr

|PLR2=2

|Runway=4

|Beacon=6}}

private, plr (default 1, custom 2), runway and beacon
Segment Type Default locks  custom plr
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 Private Road  2
 Parking Lot Road  1 2
 • • • • Ferry • • • •   5
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2
 ⁃     ⁃        ⁃        ⁃        ⁃ Runway ⁃        ⁃        ⁃        ⁃        ⁃  4
Waze Beacons installed 6



{{Locking Standard

|lede=

|caption=custom ferry, runway, other types & construction

|Ferry=2

|PLR=3

|Runway=1

|Other=1

|Construction=3}}

custom ferry, runway, other types & construction
Segment Type Default locks
 Freeway  4
 Ramp  Highest rank of connected segment
 Major Highway  3
 Minor Highway  2
 Primary Street  1
 Street  1
 Parking Lot Road  3
 • • • • Ferry • • • •   2
 |-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|  2
 ⁃     ⁃        ⁃        ⁃        ⁃ Runway ⁃        ⁃        ⁃        ⁃        ⁃  1
Other named types 1
Construction (outdated imagery) 3