Talk:USA/CommonState View history

VisualWikitext
(added state vs territory)
 
(68 intermediate revisions by 2 users not shown)
Line 3: Line 3:


== Instructions for using this page ==
== Instructions for using this page ==
This page is designed as a general template to be used when creating a USA state or territory page. Global [[Wikipedia:Help:A_quick_guide_to_templates|templates]] are used as much as possible to make maintenance much easier due to the 50+ pages that are used in the USA. Be sure not to remove any templates unless absolutely necessary and then it should only be done after review with the [{{:USA/CommonState/ForumLinkURL}} Wiki experts in the forums].


Templates serve two general purposes. They typically allow common code to be used in multiple places with parameters passed to them changing their outcome. They are also used to hold text which is common to multiple pages that may change in the future.
=== Overview ===
This [[USA/CommonState]] main page (not the talk page here) is designed as a general template to be used when creating a USA state or territory page. Global [[Wikipedia:Help:A_quick_guide_to_templates|templates]] are used as much as possible to make maintenance much easier due to the 50+ pages that are used in the USA. Be sure not to remove any templates unless absolutely necessary and then it should only be done after review with the [{{:USA/CommonState/ForumLinkURL}} Wiki experts in the forums].


Templates appear in edit mode with double braces like {{tlc|RC/Data}}. To view the actual page you would go to [[Template:RC/Data]]. In some cases the template will include a ":" like <code><nowiki>{{:USA/CommonState/Overview}}</nowiki></code>. The colon indicates the template code is in the Main: [[Wikipedia:Namespace|namespace]] and not the Template: namespace.
Templates serve two general purposes. They typically allow common code to be used in multiple places with parameters passed to them changing their outcome. They are also used to hold text which is common to multiple pages that may change in the future and therefore allow for simple updates.


The instructions are broken into two parts: 1) First time setup, and 2) Maintenance.
When viewing a page in edit mode, templates appear with double braces like {{tlx|RC/Data}}. To view the actual page you could type into the Wiki search box [[Template:RC/Data]]. In some cases the template will include a ":" like <code><nowiki>{{:USA/CommonState/Overview}}</nowiki></code>. The colon indicates the template code is in the Main: [[Wikipedia:Namespace|namespace]] and not the Template: namespace.
 
=== Theory of operation ===
In order to ensure the 50+ state and territory pages are kept up to date, all editing is done through a combination of templates.
 
==== Main state page ====
The main state page is only a wrapper for the main template {{tlx|:USA/CommonState}}. The state name provides the name used throughout the templates and subpages on that state page. There is nothing to edit on that page, ever.
 
The main page will display content into sections. Each section is broken down into four types of content.
; Common to all states (static)
: This content comes from a common template that feeds all states. It is not altered except by consensus within the forums because it alters more than 50 pages at one time. If it exists, it will appear on all state pages. If there is no 100% common content for all states, then it can be blank in the common template for all.
 
; Common to many states (selectable)
: This content comes from the same common template as above, but this content may only be common to some states. The default setup for a state will include this content.
 
; Unique state data (optional)
: Individual states can create an alternate set of unique data for each section that will automatically override the optional common content from the common template. If desired, the state unique content can be blanked (page exists, but there is no content) and it will result in only the content common to ALL states will be displayed. To get the common selectable code to appear again after a state unique section is created, the template to display that common selectable code can be copied to the state unique template. Instructions appear on the page when edited through that table on the talk page (discussed below).
 
; Unique state pages (optional)
: Each state can create a full subpage for each section of the main page. Typically the editor will include a link from the unique state content section to the subpage. Of course that same unique content section can have links to other pages that are not necessarily subpages of the main state page.
 
==== Associated Talk page ====
The talk page (discussion tab) holds a template called {{tl|EditState}}. It consists of a heading and table of links to all the sections of the state page with unique content. The editing table is dynamic to the unique sections or pages that have been created. The table guides the editor as to which pages are commonly created and which ones are typically not. Most states will not have unique content for all pages.
 
Each of the pages that are linked from the table will include combinations of code and text. Be sure to pay attention to the comments in the code directing you as to what parts of the code to change and what not to change. When using the table on the talk page, it provides the opportunity to preload content on the page that can then be further edited.
 
Nearly all of the unique content pages have an associated preload page used when they are first created. That preload code is also alterable, but only after full consensus by the other editors since these pages also affect all newly created state and territory pages. Once a page is created from the preload, future changes to that preload page will have no affect on the already created state content page. Only the actual templates on that page will be affected by updates to those templates, not the preload page.
 
To help visualize the code better, the browser plugin called [[WikEd]] will colorize much of the code on the screen helping to identify the different sections of code that should be altered vs avoided. It is easy to install and automatically loads when editing any Wiki pages.


=== First time setup ===
=== First time setup ===
Line 15: Line 43:




1. Copy the entire content of this page (the main page, not this discussion/talk page) under edit mode. Do not use the "move" page option.
{{hi|1. If the current state or territory page exists, start this new page on a page with the "YourStatename/Test" or "YourStatename/Test2." This will not affect the current page. After completion and testing of the new page, it can be moved into the place of the old one with the Move command.}}
 
 
{{hi|2. Use the {{tlx|USA Navbox}} to select the state or territory name desired. If it is red it will go to a blank page so there is no need to create a subpage with "Test". If it is blue or purple, that means there is content on the page. That means you will need to search for a page with "YourStatename/Test" and press the link to create the page.}}
{{USA Navbox|state=expanded}}
 
 
{{hi|3. Insert the following code onto the blank page as the only code.
<code><nowiki>{{subst::USA/CommonState/Start}}</nowiki></code>}}
 
 
{{hi|4. In the summary box, type '''<code>Created new STATENAME page</code>''' with STATENAME replaced with the state you are creating. Then press '''Save page'''.
}}
 
 
{{hi|5. After the page is saved, you will be taken to the page. Near the top of the screen is a yellow highlighted bar used to create a special entry on the talk (or discussion) page. Click on that yellow bar.}}




2. If the state page currently exists, paste this content on a temporary page, otherwise paste it on the pagename of the state. The automated code will only work on pages that use a valid state name as the root page name (or [[USA/CommonState]]). Direct pages ([[Arizona]]) and subpages ([[Arizona/Test]] or [[Arizona/Test/Review]]) to any level are all valid during the setup process, but the final page is designed to be on a root page name with the state or territory, like [[Arizona]].
{{hi|6. The talk page is created with the initial text for the talk page. Do not place code above that entry. The template {{tlx|EditState}} includes the heading name, and multiple screens worth of data all in that one template. It is used to customize the main page, so it is best to have the template stay at the top of the page. Press '''Save page'''.}}




These next steps are all to be carried out on the state page created in the first steps above.
{{hi|7. For newly created states, the table will appear with no active links. None of the pages will already exist. For states that already had some subpages, the table will automatically link to some of them.}}




3. Review the editor notes in each section while in edit mode and make the appropriate changes noted. Some instructions ask for some comments to be removed after the step is complete, but all other notes should be left in for future editors to see the comments.
{{hi|8. Return to the main page tab to see your new state page.}}


Here is an example of template and comment code from the page that should not be altered.
{{pre2|<nowiki>
{{:USA/CommonState/Overview}}<!-- Keep this common template.
Add additional overivew information below. Most state unique content should
go into the Introduction section below.-->


{{clear}}{{TOC left}}{{:USA/CommonState/Notice}}{{clear}}<!-- Keep as is -->
{{hi|9. State map image. If your state's map was not already loaded into the Wiki, a full set of instructions will appear on the page until you upload that file. The name of the file is highly case sensitive, so be sure to name the file matching exactly as stated in the instructions.}}
</nowiki>}}




4. Ensure there is a file with the name <code>USA_STATENAME.png</code> where STATENAME is the name of the state or territory as it appears in the pagename. Do not use all caps for the filename. Make it use the same caps as <code>USA_Arizona.png</code>.
{{hi|10. Scroll down to the Area Manager (AM) table. This is a sample table, not the final table for the state. Above the table is a info box with a link to create the table automatically. Press that link.}}




5. Integrate any content from a current state page as needed. Be sure to add the content in the appropriate sections already created.
{{hi|11. A page will be preloaded with lots of code. The AM table is only partially accessible from this view (now and in the future). The AM editors who are not State or Country Managers will edit their portion of the table from a different place coming up. All the instructions for editing and maintaining the table are on the page when in edit mode.}}




6. Keep the section templates at the top of each section for the generic information to simplify generic messages for each section across all states. Do not change the templates at the top of each section. They are generic for all states and territories as much as possible. If the state or territory for which this template is being used has a conflict with the content of one of the templates, please bring that to the attention of the [{{:USA/CommonState/ForumLinkURL}} Wiki experts in the forums].
{{hi|12. If desired, replace the example State and Country Managers, or wait until later. Press Save page. Next press the link to return to the AM table.}}




7. Resist moving sections around in this template because all states are being set up this same way. If necessary add subsections to current sections. New sections should be reviewed with other state editors to keep the template as similar as possible.
{{hi|13. A table that can be customized to your state page is almost ready. As mentioned above, the Area Managers ranked below State or Country Manager can edit their portion of the table directly from the table link in the middle of the table. Press the link now to edit the table further and save changes.}}




8. Review the final proposed page with other editors in your state.
These additional steps are not immediately required before the page is ready to be used. However there are sections that would typically get set up to identify some key state specific content.




9. Once you have consensus with the other editors, if the page was created on a temporary page, copy the entire contents in edit mode and paste it over the current contents of the state or territory page. The Wiki will keep track of all past content if there is need to look up anything in the prior version of the page.
{{hi|14. Go to the talk page and scroll down to the edit table. Each section of the main page is noted in the table. Instructions for using the table are covered on that page. The following steps are all done from this talk page table.}}




10. Remove the construction message box at the top of the page if all the content is completed and ready for use by other editors.
{{hi|15. '''Mapping resources''': Most current state pages have links to mapping resources. They should be added for the editors of the state to have easy access.}}


{{hi|16. '''Cities and towns''': Some states already have custom pages. Some states may not have the exact spelling the same as the template expects. Move the page to the template and be sure to leave a redirect to the old spelling.}}
{{hi|17. '''Cameras''': Each state had different laws regarding speed and red light camera use. This section enables the legality elements to be specific to the state. Instructions are on the camera page when in edit mode.}}
{{hi|18. '''To do list''': Many states have a to do list page. As long as the subpage is named <code>Statename/To do</code> where Statename is the name of your state or territory, it will automatically be linked.}}
{{hi|19. The other sections can be modified as well. Use the edit table on the talk page to review which pages should most likely be addressed.}}
{{hi|20. Review the state page for construction boxes (they use the special {{tlx|AddCode}} template). Those should not stay on the page once it is finalize for use by other editors. Once the task directed by that message box is completed, be sure to remove that template from that section. A few of the message boxes come from the optional common content sections and can only be removed by creating a unique state section entry from the talk page edit table for that section.}}
{{hi|21. Ensure all the appropriate content from any original state page is transferred to the new page. Everything should go into one of the current sections. In the extreme case were new material is completely disconnected from the current sections, use the '''Other''' section linked on the talk page edit box. The Other section will not appear until there is content to display.}}
{{hi|22. Review the final propose page with other editors in your state. Use the forum section to find the appropriate forum.}}
{{hi|23. Remove the construction message box at the top of the page if all the content is completed and ready for use by other editors.}}


=== Maintenance after initial creation ===
=== Maintenance after initial creation ===
Line 62: Line 122:
Most of the maintenance can be done through the subpage templates (listed below). Each section of the state page will have an associated subpage. For example the Resources section with have a template on a subpage using that same name ([[USA/CommonState/Resources]]). Go to the desired subpage to edit the content which will automatically appear on all 50+ pages.
Most of the maintenance can be done through the subpage templates (listed below). Each section of the state page will have an associated subpage. For example the Resources section with have a template on a subpage using that same name ([[USA/CommonState/Resources]]). Go to the desired subpage to edit the content which will automatically appear on all 50+ pages.


== Subpages ==
== Subpages and preloads ==
Most of these subpages are used as common templates for each section of the state page to increase consistency between states. They should only be modified after reviewing with the [{{:USA/CommonState/ForumLinkURL}} other state editors in the forum].
Most of these subpages are used as common templates for each section of the state page to increase consistency between states. They should only be modified after reviewing with the [{{:USA/CommonState/ForumLinkURL}} other state editors in the forum].


* The main page link covers the primary content for that section seen on every state page.
* The two '''Preload''' pages are used on the individual state pages when they are first created. The content on the preload page can include hints or proposed content for state editors to use when first setting up the page. Once the unique state page is created, these preload templates have no affect on those pages. Think of them as a one time guidance which is then ignored after that. Only the portion of the preload that the editor keeps on the page will remain, but any subsequent changes to the preload page will not appear on the already created unique state pages.
:* The '''Full Page Preload''' is used when creating stand alone subpages, like [[Connecticut/Cities and towns]].
:* The '''Optional Content Preload''' is used when creating the section on the main page that follows the universal content. When the optional page gets created, the optional content on the main page in that section gets displaced.
If a preload page is not created (visible as red links), then when users create a new subpage in their state there is no guidance for what might be put on the page. This is more important for the optional content pages that are viewed in the main page because special flow code is often desired.
{{:USA/CommonState/ForumLink}}
{{anchor|Subpage maintenance}}
{| class="wikitable"
{| class="wikitable"
|+ Primary Subpages
|+ Primary Subpages
! Subpage
! scope="col" width="40%" | Subpage (Preloads)
! Purpose
! Purpose
|-
|-
| [[USA/CommonState/Overview]] || Initial overview paragraph before the table of contents. Explains the purpose of the page.
| {{:USA/CommonState/TalkTableElement|Overview}} || Initial overview paragraph before the table of contents. Explains the purpose of the page.
|-
|-
| [[USA/CommonState/Notice]] || Appears to the right of the Table of Contents. Used to convey overall updates, messages, etc. Can be text, message boxes, links, etc.
| {{:USA/CommonState/TalkTableElement|Notice}} || Appears to the right of the Table of Contents. Used to convey overall updates, messages, etc. Can be text, message boxes, links, etc.
|-
|-
| [[USA/CommonState/Intro]] || Initial introductory section content. Currently contains very basic information that is common to all states and a couple of automated templates that display a little content specific to each state.
| {{:USA/CommonState/TalkTableElement|Intro}} || Initial introductory section content. Currently contains very basic information that is common to all states and a couple of automated templates that display a little content specific to each state.
|-
|-
| [[USA/CommonState/Resources]] || Initial resource section information. Typically would include links to Waze and external resources that are common to all states.  
| {{:USA/CommonState/TalkTableElement|Resources}} || Initial resource section information. Typically would include links to Waze and external resources that are common to all states.  
|-
|-
| [[USA/CommonState/Forum]] || Initial forum section information. Likely this content will be the extent of this section for most states as it automatically contains the links to each state.
| {{:USA/CommonState/TalkTableElement|Community}} || Initial forum section information. Likely this content will be the extent of this section for most states as it automatically contains the links to each state.
|-
|-
| [[USA/CommonState/CitiesTowns]] ||  
| {{:USA/CommonState/TalkTableElement|Cities and towns}} || Initial Cities and towns section information. Likely that this content will be very basic since only some states are dependent upon this page.
|-
|-
| [[USA/CommonState/MajorRoads]] ||  
| {{:USA/CommonState/TalkTableElement|Major roads}}) || Initial Major roads information.
|-
|-
| [[USA/CommonState/Places]] ||  
| {{:USA/CommonState/TalkTableElement|Places}} || Initial Places information.
|-
|-
| [[USA/CommonState/MajorConstruction]] || Initial construction section information. Currently it points to information in the Wiki on construction. Most everything else will be custom per state. The current template automatically adds the link to the construction subpage if it is created as <nowiki>STATENAME/Construction</nowiki> where STATENAME is the name of the state or territory. If no separate page exists it will allow one key Department of Transportation (or similar site) URL to be passed as a parameter like: <code><nowiki>|http://www.fhwa.dot.gov/</nowiki></code><br/>If no link is desired, pass <code>none</code> as the parameter. Most of this automation is for states that do nothing to the state page, but we want some content to be available.
| {{:USA/CommonState/TalkTableElement|Closures}} || Initial closures section information. Currently it points to information in the Wiki on closures. Most everything else will be custom per state. The current template automatically adds the link to the closures subpage if it is created as <nowiki>STATENAME/Closures</nowiki> where STATENAME is the name of the state or territory. If no separate page exists it will allow one key Department of Transportation (or similar site) URL to be passed as a parameter like: <code><nowiki>|http://www.fhwa.dot.gov/</nowiki></code><br/>If no link is desired, pass <code>none</code> as the parameter. Most of this automation is for states that do nothing to the state page, but we want some content to be available.
|-
|-
| [[USA/CommonState/Cameras]] || Initial camera section information with general links to various Wiki pages.
| {{:USA/CommonState/TalkTableElement|Cameras}} || Initial camera section information with general links to various Wiki pages.
|-
|-
| [[USA/CommonState/SpecialRoads]] || Initial special road information linking to Wiki on road type with no state unique settings. The second part of page is controlled by a state unique flag allowing the unique state page to override the second section.
| {{:USA/CommonState/TalkTableElement|Special roads}} || Initial special road information linking to Wiki on road type with no state unique settings. The second part of page is controlled by a state unique flag allowing the unique state page to override the second section.
|-
|-
| [[USA/CommonState/ToDo]] || Initial To do section information. It checks for a [[Statename/To do]] page and shows a link, otherwise it suggests creating the page and shows a link.
| {{:USA/CommonState/TalkTableElement|To do}} || Initial To do section information. It checks for a [[Statename/To do]] page and shows a link, otherwise it suggests creating the page and shows a link.
|-
|-
| [[USA/CommonState/AreaManager]] || Area Manager information at the beginning of that section
| {{:USA/CommonState/TalkTableElement|Other}} || Special section for universal expansion of state pages. Only displays if a state has specific content on their Unique Portion page accessed on their talk page. These pages default to no content and minimal state page preloads.
|-
|-
| [[USA/CommonState/OtherStates]] || Contains the {{tl|USA Navbox}} showing all states and territories.
| {{:USA/CommonState/TalkTableElement|Area Managers}} || Area Manager information at the beginning of that section.
|-
|-
| colspan="2" style="text-align: center" | Other Subpages
| [[USA/CommonState/AM/Editor/Area/Main/Preload|Area Manager Optional Content Preload]] || A preload only page for the special portion of the Area Manager table that provides the ability to edit just the Area Manager section through a link on the main Area Manager page.
|-
|-
| [[USA/CommonState/Construction]] || Minimally this page allows the template to show the existence of a separate construction page. It can be set up as an example for other states to copy if desired. Currently it is a placeholder for a demo page
| [[USA/CommonState/AM/Editor/Area2/Main/Preload|Other Area Editor Optional Content Preload]] || A preload only page for the special portion of the Other Area editors table that provides the ability to edit just the editor section through a link on the main Other Area Editor page.
|-
| {{:USA/CommonState/TalkTableElement|Other states and territories}} || Contains the {{tl|USA Navbox}} showing all states and territories.
|-
! colspan="2" style="text-align: center" | Other Subpages
|-
|-
| [[USA/CommonState/ForumLink]] || A message box that appears on each subpage telling people not to modify the contents of that page without discussion.
| [[USA/CommonState/ForumLink]] || A message box that appears on each subpage telling people not to modify the contents of that page without discussion.
|-
|-
| [[USA/CommonState/ForumLinkURL]] || The actual URL used in [[USA/CommonState/ForumLink]]
| [[USA/CommonState/ForumLinkURL]] || The actual URL used in [[USA/CommonState/ForumLink]]
 
|-
| {{:USA/CommonState/TalkTableElement|SAVED}} || A special saved page holding more complex preload files in case the <nowiki><noinclude></nowiki> and <nowiki><includeonly></nowiki> tags need to be escaped. Ignore these links for normal purposes. They are not linked to any other template. Do not modify them.
|}
|}
[http://wiki.waze.com/wiki/index.php?title=Special%3ASearch&search=USA%2FCommonState+preload&fulltext=1 Preload maintenance link]


 
All subpages for cross reference purposes. Italics are redirects:
All subpages:
{{list subpages}}
{{list subpages}}


Line 116: Line 192:
This list being managed by ''[[user:kentsmith9|<span style="background:palegreen;color:green">&laquo;&nbsp;kentsmith9&nbsp;&raquo;</span>]]&nbsp;([[User talk:kentsmith9|talk]])'' 23:01, 3 July 2014 (UTC)
This list being managed by ''[[user:kentsmith9|<span style="background:palegreen;color:green">&laquo;&nbsp;kentsmith9&nbsp;&raquo;</span>]]&nbsp;([[User talk:kentsmith9|talk]])'' 23:01, 3 July 2014 (UTC)


{| class="wikitable"
{| class="wikitable sortable"
|+ Steps to First Release
! Category
! Category
! Description
! Description
! Status
! Status
|-
| Testing
| Create test pages against current states<br/>{{*}}[[Arizona]] - {{done}}<br/>{{*}}[[Southeast]] - {{done}}<br/>{{*}}[[Connecticut]] - In process<br/>{{*}}[[West Virginia]]<br/>{{*}}[[Texas]] - {{done}}
| In process
|-
| Area Manager Table
| More info on Other Area Editors; what they are; why to add; reiterate they are not Area Managers
|
|-
| Area Manager Table
| Is there a source for knowing who are the AMs for the state to be pre-populated? Or should they add themselves?
|
|-
| Final Steps
| Move Completed To Do list items to archive and add link, but keep table for future changes after release.
|
|-
| Sections
| Add generic images to each section as appropriate.
| In process
|-
| Testing
| Update forum link to a general page for all to see. Will be a prelim Page.
| {{done}}
|-
| Area Manager Table
| Add State Manager section
| {{done}}
|-
| Talk page table
| Update section names to match actual page section names, not subpages
| {{done}}
|-
| Instructions
| Link to AM/Badge should be easier to get to with the badge information. Maybe a redirect from AM/Badge
| {{done}}
|-
| Regions
| Create special maps like [[:File:USA_Southeast.png]] for all regions.
| {{done}}
|-
| Regions
| Southeast is a region that looks like a state, so pages need to be flexible to support both types
| {{done}}
|-
| Regions
| Overview - Needs to consider territories and regions
| {{done}}
|-
| Regions
| Introduction - Takes wrong data; needs to determine if a region and then show alternate variables from Template:RC/Data
| {{done}}
|-
| Regions
| Area Managers table pulling wrong data from Template:RC/Data
| {{done}}
|-
| Regions
| Add area-type to Template:RC/Data
| {{done}}
|-
|-
| Etiquette
| Etiquette
| Include link to etiquette section of Wiki. http://wiki.waze.com/wiki/Waze_etiquette
| Include link to etiquette section of Wiki. http://wiki.waze.com/wiki/Waze_etiquette
|
| {{done}}
|-
| Area Manager table
| Integrate [[California/AMtest]] for AM editing of table.
| {{done}}
|-
|-
| Area Manager table
| Area Manager table
| Inform editors that the table is only for Rank 3 Area Managers and above.
| Inform editors that the table is only for Rank 3 Area Managers and above. Then create new action to consider automating a lower level editor table.
|
| {{done}}
|-
|-
| Area Manager table
| Area Manager table
Line 135: Line 276:
| Area Manager table
| Area Manager table
| Create commented code to enable editors to easily add the table if desired. Integrate the Heading template.
| Create commented code to enable editors to easily add the table if desired. Integrate the Heading template.
| {{done|Done for Area Manager section}}<br/>Pending for other sections
| {{done}}
|-
|-
| Area Manager Table
| Area Manager Table
| [http://www.waze.com/forum/viewtopic.php?f=338&t=96776&start=60#p827708 Create forum Icon templates to show in Comments and make background color match first icon.]
| [http://www.waze.com/forum/viewtopic.php?f=338&t=96776&start=60#p827708 Create forum Icon templates to show in Comments and make background color match first icon.]
| {{Done}}
| {{done}}
|-
|-
| Area Manager Table
| Area Manager Table
| Automate RC icons from [[Template:RC/Data]] so users need not manage them.
| Automate RC icons from [[Template:RC/Data]] so users need not manage them.
| {{Done}}
| {{done}}
|-
|-
| Area Manager Table
| Area Manager Table
| [[Template:AM/Editor]] need to determine RC status first; if true for current state then shift badges down 2>3, 1>2, RC>1 and then continue as before.
| [[Template:AM/Editor]] need to determine RC status first; if true for current state then shift badges down 2>3, 1>2, RC>1 and then continue as before.<br/><br/> Solved differently by placing the RC at the table head.
| {{Done}} Solved differently by placing the RC at the table head.
| {{done}}
|-
|-
| Area Manager Table
| Area Manager Table
| Proposal to reduce grouping to AM and CM without rank.
| Proposal to reduce grouping to AM and CM without rank.
| {{Done}}
| {{done}}
|-
| Sections
| Add generic images to each section as appropriate.
|
|-
|-
| Sections
| Sections
| Add State vs Territory to the database and don't use state generically.
| Add State vs Territory to the database and don't use state generically.
|
| {{done}}
|-
|-
| Sections
| Sections
| [http://www.waze.com/forum/viewtopic.php?f=338&t=96776&start=60#p827743 Each section must include a common template to enable single updates to display on all state pages.]
| [http://www.waze.com/forum/viewtopic.php?f=338&t=96776&start=60#p827743 Each section must include a common template to enable single updates to display on all state pages.]
| In progress with new template proposal
| {{done}}
|-
|-
| Camera
| Camera
Line 171: Line 308:
| State Image
| State Image
| Create image for when not found that links to page showing how to add new state image. Can use page in current Wiki with <nowiki>[[File:Wiki.png|50px|link=SomePage]]</nowiki>
| Create image for when not found that links to page showing how to add new state image. Can use page in current Wiki with <nowiki>[[File:Wiki.png|50px|link=SomePage]]</nowiki>
| {{done}}
|-
| Purge
| Create a dynamic return to main page with link with purge
| {{done}}
|-
| {{tl|EditState}}
| Identify which links are not typically used
| {{done}}
|-
| Final Steps
| At bottom of the template, create a box to create a section on the Talk page to add the section <nowiki>[[Editing custom sections]]</nowiki> with {{tlx|EditState}}.
| {{done}}
|-
| Final Steps
| Activate __ NOEDITSECTION __ at top of template
| {{done}}
|-
| Final Steps
| Templates of templates do not immediately update the original page above when changed; found that {{tl|purge}} will resolve the issue, but requires a user click; updated two Area Manager table links; likely need to link to future task to add link back to home page to implement this across all page changes.
[[California/Test]] will call:
:{{tlx|:USA/CommonState}} will call:
::{{tlx|:USA/CommonState/SectionProcess|To do}} will call:
:::{{tlx|:California/Test3/To do/Main}} will display:
::::[[California/Test3/To do]]
| {{done}}
|-
| Final Steps
| Ensure instructions at top of this page are all correct to final operation.
| {{done}}
|-
| Final Steps
| Before deployment to the general community, update forumURL to link to specific thread on the template. [[USA/CommonState/ForumLinkURL]]. Also update the [[USA/CommonState/ForumLink|source page]] to remove the Editor Note portion of the message.
| {{done}}
|}
<!---------------------------------------------------------------------------------><!--------------------------------------------------------------------------------->
{| class="wikitable sortable"
|+ Future Releases
! Category
! Description
! Status
|-
| EditState and others
| Suppress external link arrow with <nowiki><span class="plainlinks">[http://]</span></nowiki>
| In progress
|-
| EditState
| Change Talk page {{tl|EditState}} template to show hyperlinks in red. Further consider making the link a button.
| {{done}}
|-
| EditState
| Determine if an empty (no display) page can be detected and indicate such on the table.
|
|
|-
|-
| Testing
| Statename Talk Page
| Create test pages against current states<br/>[[Arizona]] / [[West Virginia]] / [[Texas]] / [[Connecticut]]
| Add link to expanded documentation on State Page usage
|
|
|-
|-
| Final Steps
| Main page
| Ensure instructions at top of this page are all correct to final operation.
| Add ability to edit directly from the sections using {{tl|Ed}}.
|
|
|-
|-
| Final Steps
| All pages
| Activate __ NOEDITSECTION __ at top of template
| Create link template to preload pages where appropriate. For use by users as well. Would allow avoiding having to go to talk page edit table.
|
|
|-
|-
| Final Steps
| Main template
| Move Completed To Do list items to archive and add link, but keep table for future changes after release.
| Add some static indicator on headings at the right to remind people what state they are on.
|
|
|}
|}

Latest revision as of 14:00, 24 February 2017

If you have comments or questions about this page, please come to the forums. Do not add questions on this page.


Instructions for using this page

Overview

This USA/CommonState main page (not the talk page here) is designed as a general template to be used when creating a USA state or territory page. Global templates are used as much as possible to make maintenance much easier due to the 50+ pages that are used in the USA. Be sure not to remove any templates unless absolutely necessary and then it should only be done after review with the Wiki experts in the forums.

Templates serve two general purposes. They typically allow common code to be used in multiple places with parameters passed to them changing their outcome. They are also used to hold text which is common to multiple pages that may change in the future and therefore allow for simple updates.

When viewing a page in edit mode, templates appear with double braces like {{RC/Data}}. To view the actual page you could type into the Wiki search box Template:RC/Data. In some cases the template will include a ":" like {{:USA/CommonState/Overview}}. The colon indicates the template code is in the Main: namespace and not the Template: namespace.

Theory of operation

In order to ensure the 50+ state and territory pages are kept up to date, all editing is done through a combination of templates.

Main state page

The main state page is only a wrapper for the main template {{[[::USA/CommonState|:USA/CommonState]]}}. The state name provides the name used throughout the templates and subpages on that state page. There is nothing to edit on that page, ever.

The main page will display content into sections. Each section is broken down into four types of content.

Common to all states (static)
This content comes from a common template that feeds all states. It is not altered except by consensus within the forums because it alters more than 50 pages at one time. If it exists, it will appear on all state pages. If there is no 100% common content for all states, then it can be blank in the common template for all.
Common to many states (selectable)
This content comes from the same common template as above, but this content may only be common to some states. The default setup for a state will include this content.
Unique state data (optional)
Individual states can create an alternate set of unique data for each section that will automatically override the optional common content from the common template. If desired, the state unique content can be blanked (page exists, but there is no content) and it will result in only the content common to ALL states will be displayed. To get the common selectable code to appear again after a state unique section is created, the template to display that common selectable code can be copied to the state unique template. Instructions appear on the page when edited through that table on the talk page (discussed below).
Unique state pages (optional)
Each state can create a full subpage for each section of the main page. Typically the editor will include a link from the unique state content section to the subpage. Of course that same unique content section can have links to other pages that are not necessarily subpages of the main state page.

Associated Talk page

The talk page (discussion tab) holds a template called {{EditState}}. It consists of a heading and table of links to all the sections of the state page with unique content. The editing table is dynamic to the unique sections or pages that have been created. The table guides the editor as to which pages are commonly created and which ones are typically not. Most states will not have unique content for all pages.

Each of the pages that are linked from the table will include combinations of code and text. Be sure to pay attention to the comments in the code directing you as to what parts of the code to change and what not to change. When using the table on the talk page, it provides the opportunity to preload content on the page that can then be further edited.

Nearly all of the unique content pages have an associated preload page used when they are first created. That preload code is also alterable, but only after full consensus by the other editors since these pages also affect all newly created state and territory pages. Once a page is created from the preload, future changes to that preload page will have no affect on the already created state content page. Only the actual templates on that page will be affected by updates to those templates, not the preload page.

To help visualize the code better, the browser plugin called WikEd will colorize much of the code on the screen helping to identify the different sections of code that should be altered vs avoided. It is easy to install and automatically loads when editing any Wiki pages.

First time setup

The following instructions are directed to the editor who is first setting up this template for a state.


1. If the current state or territory page exists, start this new page on a page with the "YourStatename/Test" or "YourStatename/Test2." This will not affect the current page. After completion and testing of the new page, it can be moved into the place of the old one with the Move command.


2. Use the {{USA Navbox}} to select the state or territory name desired. If it is red it will go to a blank page so there is no need to create a subpage with "Test". If it is blue or purple, that means there is content on the page. That means you will need to search for a page with "YourStatename/Test" and press the link to create the page.

v · d · e
USA
Great Lakes
Mid Atlantic
New England
Northeast
Northwest
Plains
South Atlantic
South Central
Southeast
Southwest
Territories


3. Insert the following code onto the blank page as the only code. {{subst::USA/CommonState/Start}}


4. In the summary box, type Created new STATENAME page with STATENAME replaced with the state you are creating. Then press Save page.


5. After the page is saved, you will be taken to the page. Near the top of the screen is a yellow highlighted bar used to create a special entry on the talk (or discussion) page. Click on that yellow bar.


6. The talk page is created with the initial text for the talk page. Do not place code above that entry. The template {{EditState}} includes the heading name, and multiple screens worth of data all in that one template. It is used to customize the main page, so it is best to have the template stay at the top of the page. Press Save page.


7. For newly created states, the table will appear with no active links. None of the pages will already exist. For states that already had some subpages, the table will automatically link to some of them.


8. Return to the main page tab to see your new state page.


9. State map image. If your state's map was not already loaded into the Wiki, a full set of instructions will appear on the page until you upload that file. The name of the file is highly case sensitive, so be sure to name the file matching exactly as stated in the instructions.


10. Scroll down to the Area Manager (AM) table. This is a sample table, not the final table for the state. Above the table is a info box with a link to create the table automatically. Press that link.


11. A page will be preloaded with lots of code. The AM table is only partially accessible from this view (now and in the future). The AM editors who are not State or Country Managers will edit their portion of the table from a different place coming up. All the instructions for editing and maintaining the table are on the page when in edit mode.


12. If desired, replace the example State and Country Managers, or wait until later. Press Save page. Next press the link to return to the AM table.


13. A table that can be customized to your state page is almost ready. As mentioned above, the Area Managers ranked below State or Country Manager can edit their portion of the table directly from the table link in the middle of the table. Press the link now to edit the table further and save changes.


These additional steps are not immediately required before the page is ready to be used. However there are sections that would typically get set up to identify some key state specific content.


14. Go to the talk page and scroll down to the edit table. Each section of the main page is noted in the table. Instructions for using the table are covered on that page. The following steps are all done from this talk page table.


15. Mapping resources: Most current state pages have links to mapping resources. They should be added for the editors of the state to have easy access.


16. Cities and towns: Some states already have custom pages. Some states may not have the exact spelling the same as the template expects. Move the page to the template and be sure to leave a redirect to the old spelling.


17. Cameras: Each state had different laws regarding speed and red light camera use. This section enables the legality elements to be specific to the state. Instructions are on the camera page when in edit mode.


18. To do list: Many states have a to do list page. As long as the subpage is named Statename/To do where Statename is the name of your state or territory, it will automatically be linked.


19. The other sections can be modified as well. Use the edit table on the talk page to review which pages should most likely be addressed.


20. Review the state page for construction boxes (they use the special {{AddCode}} template). Those should not stay on the page once it is finalize for use by other editors. Once the task directed by that message box is completed, be sure to remove that template from that section. A few of the message boxes come from the optional common content sections and can only be removed by creating a unique state section entry from the talk page edit table for that section.


21. Ensure all the appropriate content from any original state page is transferred to the new page. Everything should go into one of the current sections. In the extreme case were new material is completely disconnected from the current sections, use the Other section linked on the talk page edit box. The Other section will not appear until there is content to display.


22. Review the final propose page with other editors in your state. Use the forum section to find the appropriate forum.


23. Remove the construction message box at the top of the page if all the content is completed and ready for use by other editors.

Maintenance after initial creation

This overall template uses many subtemplates to make maintenance easy for future changes across all the 50+ pages. That is why it is important to keep them in the template. Be sure to review all proposed changes to templates with the other editors in the forums before making any changes.

Most of the maintenance can be done through the subpage templates (listed below). Each section of the state page will have an associated subpage. For example the Resources section with have a template on a subpage using that same name (USA/CommonState/Resources). Go to the desired subpage to edit the content which will automatically appear on all 50+ pages.

Subpages and preloads

Most of these subpages are used as common templates for each section of the state page to increase consistency between states. They should only be modified after reviewing with the other state editors in the forum.

  • The main page link covers the primary content for that section seen on every state page.
  • The two Preload pages are used on the individual state pages when they are first created. The content on the preload page can include hints or proposed content for state editors to use when first setting up the page. Once the unique state page is created, these preload templates have no affect on those pages. Think of them as a one time guidance which is then ignored after that. Only the portion of the preload that the editor keeps on the page will remain, but any subsequent changes to the preload page will not appear on the already created unique state pages.
  • The Full Page Preload is used when creating stand alone subpages, like Connecticut/Cities and towns.
  • The Optional Content Preload is used when creating the section on the main page that follows the universal content. When the optional page gets created, the optional content on the main page in that section gets displaced.

If a preload page is not created (visible as red links), then when users create a new subpage in their state there is no guidance for what might be put on the page. This is more important for the optional content pages that are viewed in the main page because special flow code is often desired.

This page serves as a common template to over 50 other pages. Do not make modifications to this page before reviewing the proposed changes in this Waze forum thread first.

Primary Subpages
Subpage (Preloads) Purpose
USA/CommonState/Overview
(Full Page Preload)
(Optional Content Preload)		 Initial overview paragraph before the table of contents. Explains the purpose of the page.
USA/CommonState/Notice
(Full Page Preload)
(Optional Content Preload)		 Appears to the right of the Table of Contents. Used to convey overall updates, messages, etc. Can be text, message boxes, links, etc.
USA/CommonState/Intro
(Full Page Preload)
(Optional Content Preload)		 Initial introductory section content. Currently contains very basic information that is common to all states and a couple of automated templates that display a little content specific to each state.
USA/CommonState/Resources
(Full Page Preload)
(Optional Content Preload)		 Initial resource section information. Typically would include links to Waze and external resources that are common to all states.
USA/CommonState/Community
(Full Page Preload)
(Optional Content Preload)		 Initial forum section information. Likely this content will be the extent of this section for most states as it automatically contains the links to each state.
USA/CommonState/Cities and towns
(Full Page Preload)
(Optional Content Preload)		 Initial Cities and towns section information. Likely that this content will be very basic since only some states are dependent upon this page.
USA/CommonState/Major roads
(Full Page Preload)
(Optional Content Preload))		 Initial Major roads information.
USA/CommonState/Places
(Full Page Preload)
(Optional Content Preload)		 Initial Places information.
USA/CommonState/Closures
(Full Page Preload)
(Optional Content Preload)		 Initial closures section information. Currently it points to information in the Wiki on closures. Most everything else will be custom per state. The current template automatically adds the link to the closures subpage if it is created as STATENAME/Closures where STATENAME is the name of the state or territory. If no separate page exists it will allow one key Department of Transportation (or similar site) URL to be passed as a parameter like: |http://www.fhwa.dot.gov/
If no link is desired, pass none as the parameter. Most of this automation is for states that do nothing to the state page, but we want some content to be available.
USA/CommonState/Cameras
(Full Page Preload)
(Optional Content Preload)		 Initial camera section information with general links to various Wiki pages.
USA/CommonState/Special roads
(Full Page Preload)
(Optional Content Preload)		 Initial special road information linking to Wiki on road type with no state unique settings. The second part of page is controlled by a state unique flag allowing the unique state page to override the second section.
USA/CommonState/To do
(Full Page Preload)
(Optional Content Preload)		 Initial To do section information. It checks for a Statename/To do page and shows a link, otherwise it suggests creating the page and shows a link.
USA/CommonState/Other
(Full Page Preload)
(Optional Content Preload)		 Special section for universal expansion of state pages. Only displays if a state has specific content on their Unique Portion page accessed on their talk page. These pages default to no content and minimal state page preloads.
USA/CommonState/Area Managers
(Full Page Preload)
(Optional Content Preload)		 Area Manager information at the beginning of that section.
Area Manager Optional Content Preload A preload only page for the special portion of the Area Manager table that provides the ability to edit just the Area Manager section through a link on the main Area Manager page.
Other Area Editor Optional Content Preload A preload only page for the special portion of the Other Area editors table that provides the ability to edit just the editor section through a link on the main Other Area Editor page.
USA/CommonState/Other states and territories
(Full Page Preload)
(Optional Content Preload)		 Contains the {{USA Navbox}} showing all states and territories.
Other Subpages
USA/CommonState/ForumLink A message box that appears on each subpage telling people not to modify the contents of that page without discussion.
USA/CommonState/ForumLinkURL The actual URL used in USA/CommonState/ForumLink
USA/CommonState/SAVED
(Full Page Preload)
(Optional Content Preload)		 A special saved page holding more complex preload files in case the <noinclude> and <includeonly> tags need to be escaped. Ignore these links for normal purposes. They are not linked to any other template. Do not modify them.

Preload maintenance link

All subpages for cross reference purposes. Italics are redirects:

In this Talkspace:

USA/CommonState
  • USA/CommonState/AM/Editor/Area2/Main/Preload
  • USA/CommonState/AreaManager
  • USA/CommonState/AreaText
  • USA/CommonState/Area Managers
  • USA/CommonState/Area Managers/Main/Preload
  • USA/CommonState/Area Managers/Preload
  • USA/CommonState/Cameras
  • USA/CommonState/Cameras/Law
  • USA/CommonState/Cameras/Main/Preload
  • USA/CommonState/Cameras/Preload
  • USA/CommonState/Cities and towns
  • USA/CommonState/Cities and towns/Main/Preload
  • USA/CommonState/Cities and towns/Preload
  • USA/CommonState/Closures
  • USA/CommonState/Closures/Main/Preload
  • USA/CommonState/Closures/Preload
  • USA/CommonState/Community
  • USA/CommonState/Community/Main/Preload
  • USA/CommonState/Community/Preload
  • USA/CommonState/Construction
  • USA/CommonState/Construction/Main/Preload
  • USA/CommonState/Construction/Preload
  • USA/CommonState/ForumLink
  • USA/CommonState/ForumLinkURL
  • USA/CommonState/Inst/LoadImage
  • USA/CommonState/Intro
  • USA/CommonState/Intro/Main/Preload
  • USA/CommonState/Intro/Preload
  • USA/CommonState/MajorConstruction
  • USA/CommonState/Major roads
  • USA/CommonState/Major roads/Main/Preload
  • USA/CommonState/Major roads/Preload
  • USA/CommonState/Notice
  • USA/CommonState/Notice/Main/Preload
  • USA/CommonState/Notice/Preload
  • USA/CommonState/Other
  • USA/CommonState/Other/Main/Preload
  • USA/CommonState/Other/Preload
  • USA/CommonState/OtherStates
  • USA/CommonState/OtherStates/Main/Preload
  • USA/CommonState/OtherStates/Preload
  • USA/CommonState/Other states and territories
  • USA/CommonState/Other states and territories/Main/Preload
  • USA/CommonState/Other states and territories/Preload
  • USA/CommonState/Overview
  • USA/CommonState/Overview/Main/Preload
  • USA/CommonState/Overview/Preload
  • USA/CommonState/Places
  • USA/CommonState/Places/Main/Preload
  • USA/CommonState/Places/Preload
  • USA/CommonState/Resources
  • USA/CommonState/Resources/Main/Preload
  • USA/CommonState/Resources/Preload
  • USA/CommonState/ReturnPurge
  • USA/CommonState/ReturnPurge/doc
  • USA/CommonState/SAVED/Main/Preload
  • USA/CommonState/SAVED/Preload
  • USA/CommonState/SectionProcess
  • USA/CommonState/Settings
  • USA/CommonState/Settings/Preload
  • USA/CommonState/SpecialRoads
  • USA/CommonState/SpecialRoads/Main/Preload
  • USA/CommonState/SpecialRoads/Preload
  • USA/CommonState/Special roads
  • USA/CommonState/Special roads/Main/Preload
  • USA/CommonState/Special roads/Preload
  • USA/CommonState/Start
  • USA/CommonState/Talk/Preload
  • USA/CommonState/TalkTableElement
  • USA/CommonState/To do
  • USA/CommonState/To do/Main/Preload
  • USA/CommonState/To do/Preload
  • USA/CommonState/UniqueSectionMsg
  • USA/CommonState/doc

    • Other notes during template construction

    To do list

    This list being managed by « kentsmith9 » (talk) 23:01, 3 July 2014 (UTC)

    Steps to First Release
    Category Description Status
    Testing Create test pages against current states
     • Arizona - Done
     • Southeast - Done
     • Connecticut - In process
     • West Virginia
     • Texas - Done     		In process
    Area Manager Table More info on Other Area Editors; what they are; why to add; reiterate they are not Area Managers
    Area Manager Table Is there a source for knowing who are the AMs for the state to be pre-populated? Or should they add themselves?
    Final Steps Move Completed To Do list items to archive and add link, but keep table for future changes after release.
    Sections Add generic images to each section as appropriate. In process
    Testing Update forum link to a general page for all to see. Will be a prelim Page. Done
    Area Manager Table Add State Manager section Done
    Talk page table Update section names to match actual page section names, not subpages Done
    Instructions Link to AM/Badge should be easier to get to with the badge information. Maybe a redirect from AM/Badge Done
    Regions Create special maps like File:USA_Southeast.png for all regions. Done
    Regions Southeast is a region that looks like a state, so pages need to be flexible to support both types Done
    Regions Overview - Needs to consider territories and regions Done
    Regions Introduction - Takes wrong data; needs to determine if a region and then show alternate variables from Template:RC/Data Done
    Regions Area Managers table pulling wrong data from Template:RC/Data Done
    Regions Add area-type to Template:RC/Data Done
    Etiquette Include link to etiquette section of Wiki. http://wiki.waze.com/wiki/Waze_etiquette Done
    Area Manager table Integrate California/AMtest for AM editing of table. Done
    Area Manager table Inform editors that the table is only for Rank 3 Area Managers and above. Then create new action to consider automating a lower level editor table. Done
    Area Manager table Confirm from forum that less than Rank 3 is desired. Done
    Area Manager table Create commented code to enable editors to easily add the table if desired. Integrate the Heading template. Done
    Area Manager Table Create forum Icon templates to show in Comments and make background color match first icon. Done
    Area Manager Table Automate RC icons from Template:RC/Data so users need not manage them. Done
    Area Manager Table Template:AM/Editor need to determine RC status first; if true for current state then shift badges down 2>3, 1>2, RC>1 and then continue as before.

    Solved differently by placing the RC at the table head.     		Done
    Area Manager Table Proposal to reduce grouping to AM and CM without rank. Done
    Sections Add State vs Territory to the database and don't use state generically. Done
    Sections Each section must include a common template to enable single updates to display on all state pages. Done
    Camera Move content on Camera placement from Texas page to cameras page. That camera page is already linked and noted on the CommonState page. Done
    State Image Create image for when not found that links to page showing how to add new state image. Can use page in current Wiki with [[File:Wiki.png|50px|link=SomePage]] Done
    Purge Create a dynamic return to main page with link with purge Done
    {{EditState}} Identify which links are not typically used Done
    Final Steps At bottom of the template, create a box to create a section on the Talk page to add the section [[Editing custom sections]] with {{EditState}}. Done
    Final Steps Activate __ NOEDITSECTION __ at top of template Done
    Final Steps Templates of templates do not immediately update the original page above when changed; found that {{purge}} will resolve the issue, but requires a user click; updated two Area Manager table links; likely need to link to future task to add link back to home page to implement this across all page changes.

    California/Test will call:

    {{[[::USA/CommonState|:USA/CommonState]]}} will call:
    {{[[::USA/CommonState/SectionProcess|:USA/CommonState/SectionProcess]]|To do}} will call:
    {{[[::California/Test3/To do/Main|:California/Test3/To do/Main]]}} will display:
    California/Test3/To do
    		 Done
    Final Steps Ensure instructions at top of this page are all correct to final operation. Done
    Final Steps Before deployment to the general community, update forumURL to link to specific thread on the template. USA/CommonState/ForumLinkURL. Also update the source page to remove the Editor Note portion of the message. Done
    Future Releases
    Category Description Status
    EditState and others Suppress external link arrow with <span class="plainlinks">[http://]</span> In progress
    EditState Change Talk page {{EditState}} template to show hyperlinks in red. Further consider making the link a button. Done
    EditState Determine if an empty (no display) page can be detected and indicate such on the table.
    Statename Talk Page Add link to expanded documentation on State Page usage
    Main page Add ability to edit directly from the sections using {{Ed}}.
    All pages Create link template to preload pages where appropriate. For use by users as well. Would allow avoiding having to go to talk page edit table.
    Main template Add some static indicator on headings at the right to remind people what state they are on.
    Retrieved from "https://beta.waze.com/wiki/Mauritius/index.php?title=Talk:USA/CommonState&oldid=151833"