ASDSO Dam Safety Toolbox

Guidelines for Creating a State Dam Safety Page: Difference between revisions

From ASDSO Dam Safety Toolbox
Jump to: navigation, search
(Created page with "__NOTOC__ Category: Dam Safety Toolbox Formatting/Style Guide ---- <noautolinks>State Dam Safety pages provide a platform for each state dam safety program to share information specific to working on dams in their state. This can include references to specific state statutes related to dams, any rules promulgated by the state related to dams, and any specific guidelines published by the agency. A link to the landing page for the state agency on the damsafety.org site...")
 
No edit summary
Line 9: Line 9:


== Typical State Page Content ==
== Typical State Page Content ==
At a minimum, a Topic Page will include a page name/title and introductory text (e.g., a definition of a given term). A thoroughly developed Topic Page may include any and all of the following content:
At a minimum, a State Page will include the State Name and introductory text (e.g., Department/Division of State Gov't). A thoroughly developed State Page may include any and all of the following content:
   
   
# '''State Page Title''' (see section above regarding the importance of naming a new Topic Page)
# '''State Page Title'''  
# '''Breadcrumb Menu Navigation Links'''  
# '''Breadcrumb Menu Navigation Links'''  
#* ''[[Guidelines for Adding "Breadcrumbs" to a Page | Learn how to create breadcrumb menu navigation links]]''
#* ''[[Guidelines for Adding "Breadcrumbs" to a Page | Learn how to create breadcrumb menu navigation links]]''
Line 23: Line 23:
#* ''[[Guidelines for Inserting Links | Learn how to create internal and external links]]''
#* ''[[Guidelines for Inserting Links | Learn how to create internal and external links]]''
# '''Regulations''' that are promulgated in accordance with state statutes.  These typically require a public review/comment phase prior to publication.   
# '''Regulations''' that are promulgated in accordance with state statutes.  These typically require a public review/comment phase prior to publication.   
#* Recommend creating a new "Other Resource" page to contain the latest regulations.  This can be updated as rules are revised.
#* Recommend creating a link to an external page to contain the latest regulations.  This can be updated as rules are revised.
#* [[Guidelines for Creating a Resource Page | ''Learn how to create a New Other Resource Page'']]
#* [[Guidelines for Creating a Resource Page | ''Learn how to create a New Other Resource Page'']]
#* ''[[Guidelines for Inserting Links | Learn how to create internal and external links]]''
#* ''[[Guidelines for Inserting Links | Learn how to create internal and external links]]''
Line 64: Line 64:
''<nowiki></nowiki></br>
''<nowiki></nowiki></br>
''<nowiki><!-- Introductory paragraph or topic page summary --> </nowiki></br>
''<nowiki><!-- Introductory paragraph or topic page summary --> </nowiki></br>
''<nowiki>{{Website Icon}} <!-- External Link Format --> [https://damsafety.org/StateName ASDSO's Summary Page for StateName] </nowiki></br>
''<nowiki>Paragraph text </nowiki></br>
''<nowiki>Paragraph text </nowiki></br>
''<nowiki></nowiki></br>
''<nowiki></nowiki></br>

Revision as of 21:19, 4 December 2023

State Dam Safety pages provide a platform for each state dam safety program to share information specific to working on dams in their state. This can include references to specific state statutes related to dams, any rules promulgated by the state related to dams, and any specific guidelines published by the agency. A link to the landing page for the state agency on the damsafety.org site should be included. That landing page has contact information and a link to the actual agency website which is updated regularly and need not be duplicated on the damtoolbox page.

The purpose of these pages is to be an easy point of access for relevant information engineers and other regulators to learn the nuances of working on dams in states they aren't familiar with. Sharing information and approaches to effective methods of regulation and program management should help to foster innovation and minimize duplication of efforts.

Headings should generally be organized by level of authority. For example, Statutes should be listed first, Rules promulgated in accordance with the statutory authority listed second, and Guidelines or Technical Memos published by the agency which are not subject to any public hearing or review should be listed last. Links to the agency's YouTube channel or other social media platforms can also be shared.

Typical State Page Content

At a minimum, a State Page will include the State Name and introductory text (e.g., Department/Division of State Gov't). A thoroughly developed State Page may include any and all of the following content:

  1. State Page Title
  2. Breadcrumb Menu Navigation Links
  3. Introductory Paragraph (typically 100 to 500 words in length)
  4. Dam Safety Program Logo & Interesting Photo (for visual identification and aesthetic purposes)
  5. Statutes that govern the regulation of dams in the state
  6. Regulations that are promulgated in accordance with state statutes. These typically require a public review/comment phase prior to publication.
  7. Guidance Documents that are applicable for working in the state. These are classified as "Other Resources" since they may not be as thoroughly vetted as best practices documents, but are still valuable resources for engineers working on a dam in the state or for other regulatory agencies that may be looking for examples. Examples include guidance documents and tools developed by state dam safety agencies for performing hazard classification evaluations, hydrology studies, sub-surface investigation plans, seismic hazard assessments, seepage/slope stability evaluations, etc.
  8. List of Trainings that are offered by the state. Examples include dam owner trainings and include recorded webiinars, presentations, etc.
  9. Other Links (Optional)
  10. Revision History should be included at the bottom of every page.


New State Page Template Code

The following template code should be copied and pasted into the editor when creating a new StatePage to facilitate the process of creating, formatting, and reviewing new content. Contributors should add or delete sections, pictures, and code as necessary for a specific topic.

<!-- Default code to remove table of contents and add line break at top of page -->
 __NOTOC__
<!-- Add Category to drive breadcrumb menus -->
[[Category:Undefined]]
----
<!-- Insert image using {{Picture}} template -->
 {{Picture
<!-- Add image file name (ex.image.jpg) -->
|image= 1.jpg
 <!--Add link if applicable -->
|link=
<!-- Add picture caption -->
|caption= This is a dam.
 }}

<!-- Introductory paragraph or topic page summary -->
{{Website Icon}} <!-- External Link Format --> [https://damsafety.org/StateName ASDSO's Summary Page for StateName]
Paragraph text

== Statutes ==
{{Website Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]

== Rules ==
{{Website Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]

<!-- To facilitate updates to the website, do not include the year/date of a reference listed here in the Best Practices Resources section. -->
 == Guidance Documents ==
{{Website Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]
{{Video Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]
{{Document Icon}} [[Page Name | Title, Author]]

== Other Resources ==
{{Website Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]
{{Video Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]
{{Document Icon}} [[Page Name | Title, Author]]

== Trainings ==
{{Website Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]
{{Video Icon}} <!-- External Link Format --> [ExternalURL Displayed Text]
{{Document Icon}} [[Page Name | Title, Author]]

<!-- Citations will automatically populate if instructions on the "Guidelines for Inserting a Citation" are followed. -->
 {{Citations}}

<!-- Revision history information -->
{{revhistinf}}


Revision ID: 7770
Revision Date: 12/04/2023

Retrieved from "https://damtoolbox.org/index.php?title=Guidelines_for_Creating_a_State_Dam_Safety_Page&oldid=7770"