Template:Locking Standard/doc

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.

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), and Ferries (which are limited to very specialized use if used at all, and therefore are set to 5). 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.

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 • • • •	5
|-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|	2

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

Examples:

Simplest, using only defaults except for eliminating the lede, changing captions and changing one lock level (Freeway=5 instead of 4)

{{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

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)

{{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}}

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
Major Highway	5	3	4
Minor Highway	2
Primary Street	1
Street	1
• • • • Ferry • • • •	5
|-|-|-|-|-|-|-|-|-| Railroad |-|-|-|-|-|-|-|-|-|	2

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|.

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.

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.

Parameters (exact capitalization matters):

• lede: Lede paragraph. There is some default text otherwise. To have no lede paragraph, make sure to set it to a blank value: |Lede=|
• caption: The title above the table (not a wiki heading). Defaults to Xyzyz Locking Standard, where Xyzyz is taking from the page title (and would be the state name if you use Kent's state template scheme)
• title: The title of the first column of lock values (sometimes the only column). Default value is "Default lock"
• Title2, Title3: Column titles for second and third variants. If you do not specify a title, the column will not appear. No default.
• Fwy, Fwy2, Fwy3: The Freeway values, defaults to 4
• 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