m
 
(54 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The conversion of the Minnesota Stormwater Manual into a web-based application will create a new learning curve for users of the Manual.  In addition to the web-based format, versus the traditional hardcopy and pdf formats, the contents of the manual have been re-arranged.  This guidance provides Manual users information on why we went to a web-based format, why the content was re-arranged, what the formatting style is, and most importantly, how to navigate the website.
+
[[File:Guidance clipart 1.jpg|300 px|thumbnail|alt=clipart showing a person working on a computer]]
  
==Why a web-based format?==
+
The conversion of the Minnesota Stormwater Manual into a web-based application will create a new learning curve for users of the Manual. In addition to the web-based format versus the traditional hardcopy and pdf formats, the contents of the manual have been re-arranged. This guidance provides Manual users information on why we went to a web-based format, why the content was re-arranged, what the formatting style is, and most importantly, how to navigate the website.
We live in an electronic world.  There are now more mobile devices than people in the United States, and more than half of these devices have Internet access.  People not only want electronic access, they want to find a topic quickly. This requires powerful search capability and advanced use of links.  Although many users may wish to print out portions of the Manual, printing options are excellent and can satisfy most user's needs.
 
  
==Why a wiki format?==
 
A wiki was specifically chosen for the following reasons:
 
*It can easily be updated.  This is critical for stormwater, since new information is being generated on a daily basis.  We anticipate being able to provide updates consistently on a weekly to monthly basis.
 
*Topics or new information can be added easily.  The wiki is dynamic in that a new sub-section, section or even chapter can be added at any time.
 
*A wiki allows for excellent internal linking between and within articles.
 
*Mediawiki, the platform on which this website is built, is well established and addresses most of the issues that need to be addressed in building, maintaining, and using the website.  Examples include an existing Manual of Style and several extensions that allow for writing formulas, citing the Manual, printing and exporting, and creating a book.
 
*The wiki is easily maintained and supported by technical staff.
 
  
==Why and how was the arrangement of the content changed?==
+
[[Guidance - General Information]]
It was determined that the content of the Manual could be better organized.  There were three areas where improvements could be made.
 
*The 2008 updates to the Manual were never incorporated directly into the Manual, but instead were added as appendices.  It was considered important to bring all information on a particular topic together and avoid the potential for conflicting information as updates were made.
 
*Information in some chapters could be combined.  For example, chapter 10, which addresses uniform sizing criteria, could be combined with Chapter 12, which provides BMP information.  Chapter 11, which addresses stormwater credits, could be combined with Chapter 8 and Appendix B, both of which address modeling.
 
*The chapters could be organized to flow better.  To address this, the following model was selected;
 
**provide general information about stormwater
 
**discuss the stormwater treatment train
 
**discuss the BMPs that can be used in the treatment train approach
 
**discuss pollutant and volume reductions, or credits, that can achieved with BMPs
 
**provide a regulatory context
 
**provide other information such as Minnesota-specific information, definitions, lists of acronyms, and so on.
 
  
==Stormwater Manual Style Guide==
+
[[Navigating the website]]
The [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia Manual of Style] guide was adapted for this website.  It provides information on formatting guidelines.
 
  
==Accessibility Manual of Style==
+
[[Finding a topic]]
The [http://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Accessibility Wikipedia Accessibility Manual of Style] guide was adapted for this website. It provides information on formatting guidelines for ADA (American Disabilities Act) compliance.
 
  
==I knew where it was in the old manual, but where is it now?==
+
[[The left sidebar]]
Most of the material in the 2008 Manual was migrated to the wiki.  We have developed a [[quick guide|Guide for finding old manual content]] to help you determine where the old material now resides.
 
  
==Navigating the website==
+
[[Tables, images and downloadable files]]
 
 
This section provides basic information to allow the user to navigate the website.
 
 
 
===Information and functions found on all pages in the website===
 
[[File:Manual guide 1.jpg|500 px|thumbnail|Alt=image showing contents found on every page - top portion|This screen shot illustrates information and functionality found on the top portion of every page in the website.  The picture illustrates the MPCA logo, Minnesota Stormwater Manual header, search box, last three pages accessed, and the left sidebar.]]
 
[[File:Manual guide 2.jpg|500 px|thumbnail|alt=image showing contents found on every page - bottom portion|This screen shot illustrates information and functionality found on the bottom portion of every page in the website.  The picture illustrates the comment/feedback box, the date the page was last updated, MPCA contact information, and copyright information.]]
 
The following information and functions are found on every page in the website.
 
*The MPCA logo, found in the upper left portion of the page.
 
*A header at the top of the page called Minnesota Stormwater Manual.
 
*A search box and magnifying glass in the upper right portion of the website.
 
*[[#The left sidebar|The left sidebar]].
 
*Links to the last three pages accessed by the user during their current session within the website.  These links are found near the top center portion of each page and are in small, blue font.  The most recent link accessed during the current session is shown last.
 
*A section called '''''Help improve this page'''''.  This section contains a comment box in which users can send comments or corrections to the editors.  Note that any information submitted is public information and can be viewed by any user of the website.
 
*A list of categories to which the current page belongs.
 
*The last date when the site was updated
 
*MPCA contact information and links to assistance and website policy.
 
*Copyright information
 
 
 
 
===The Main page===
 
The Main page is the equivalent of the Stormwater Manual home page.  In addition to the information and functions found on every page it contains the following:
 
*The Minnesota Clean Water, Land and Legacy Amendment logo.  Funding to build this website was provided through the Clean Water, Land and Legacy Amendment.
 
*A picture of the cover of the 2006 version of the Minnesota Stormwater Manual.
 
*A link to the Manual Table of Contents.
 
*A link to a list of contributors to the Minnesota Stormwater Manual (Acknowledgements)
 
*A link to this guidance document
 
 
 
===The left sidebar===
 
The left sidebar contains much of the functionality for the user.  It includes links, help, printing and exporting functions, citing functions, and more.  These are explained in greater detail below.
 
 
 
====The left sidebar - Navigation====
 
The left sidebar on the website provides many potentially useful functions for the user.  Each of the items in the sidebar are explained below.
 
 
 
=====Main page=====
 
This link takes you to the Main Page.  This is the "Home page" for the Stormwater Manual.  From here you can link to the Table of Contents or find some general information about the website, including access to guidance on using the website, Acknowledgements, a summary of recent important updates, and feedback.
 
 
 
 
 
=====Table of contents=====
 
This link takes you to the Table of Contents for the Manual.  From here you can cursor down to the section of the Manual you want to view or use the Page Contents in the upper right part of the screen to display the contents of the page, from where you select the section you want to view.
 
 
 
=====Categories=====
 
The wiki allows different subjects to be placed into different categories.  This allows a user to view just the topics within a particular category.  For example, '''''Fact sheets''''' could be a category that includes all the fact sheets contained within the website.  A user could click on category and open the page with all categories.  The user would then select the category called '''''Fact sheets''''' to display links to the different fact sheets within the website.  The number of categories will continue to grow as the website becomes populated and organized.
 
 
 
=====Events=====
 
The link takes you to a short list of events.  '''NOTE THE MPCA DOES NOT ENDORSE SPECIFIC EVENTS.'''  Only events in which the MPCA participates are listed.
 
 
 
=====Recent changes=====
 
The wiki stores all previous versions of the website.  Any change results in the previous version being stored.  Users can therefore view any previous version of the website.  This page does not specify changes that were made.  However, the user can choose specific dates when previous versions existed.
 
 
 
=====Help=====
 
The Help page contains two basic groups of information.  First is a link to this guidance document, which provides help on a variety of topics.  The second category of information is for editors of the wiki.  Examples include links to math and formatting instructions.
 
 
 
====The left sidebar - Toolbox====
 
The Toolbox contains links to pages that primarily used by the editors of the website.  These are not explained in this guidance.  However, '''''What links here''''' may have utility for some users.  This page provides a summary of and links to other pages that have links within the page that you are on.
 
 
 
====The left sidebar - MPCA links====
 
Links are provided to the MPCA homepage, MPCA's stormwater main page, and a webpage containing MPCA policies and disclaimers.
 
 
 
====The left sidebar - Print/Export====
 
 
 
This section of the sidebar allows the user to print, export, and build their own documents.
 
 
 
=====Create a book=====
 
 
 
Users can combine webpages (e.g. articles) using this utility. For example, if a user wanted to combine all the sections that provide information on credits for individual BMPs, this can be done by creating a book containing these webpages.  The pages can be ordered in any manner.  The user can save the book or create a PDF document containing the selected webpages.
 
 
 
=====Export as PDF=====
 
 
 
Users can export the page they are currently on as a PDF document.
 
 
 
=====Printable version=====
 
 
 
Clicking on this link takes the user to a version of the webpage that does not contain the headers, footers and toolbars found on any given page in the website. The view observed on the screen will be what the user obtains when they print from this page.
 
 
 
===Finding a topic===
 
Each webpage within the website is essentially an article.  The Manual is therefore a collection of articles, each with its own webpage.  Articles usually contain multiple sub-sections.  We attempted to keep articles at a reasonable length, dividing a topic into multiple articles when the length for a single article became too long.
 
 
 
====Using the Table of Contents====
 
You can access the [[Stormwater Manual Table of Contents]] from the home page.  There is a link at the top of the home page.  The Table of Contents is divided into the following chapters:
 
*General information
 
*Stormwater treatment
 
*Best Management Practices
 
*Stormwater modeling, models and calculators, and calculating credits
 
*Regulatory
 
*Minnesota specific applications
 
*Case studies
 
*Fact sheets
 
*CADD drawings
 
*Construction Stormwater Manual (Blue Book)
 
*Industrial stormwater
 
*Acronyms and definitions
 
Each of these chapters has two or more sub-sections.
 
<p>Clicking on a topic link from the Table of Contents may take you directly to an article or to another table of contents.  For example, most of the BMPs discussed in the chapter [[Best Management Practices]] have multiple articles.  We have attempted to minimze the number of clicks needed to get to an article while not making the articles excessive in length.</p>
 
 
 
====Using the search function====
 
 
 
===Structure of each article===
 
 
 
===Understanding internal links===
 
 
 
===Understanding external links===
 
 
 
===Printing===
 
 
 
===Citing the Manual===
 
 
 
===Exporting to a pdf or Word document===
 
 
 
===Creating a book===
 
 
 
===Pictures, tables, and other images===
 
 
 
[[category:Stormwater articles]]
 

Latest revision as of 20:46, 19 July 2022

clipart showing a person working on a computer

The conversion of the Minnesota Stormwater Manual into a web-based application will create a new learning curve for users of the Manual. In addition to the web-based format versus the traditional hardcopy and pdf formats, the contents of the manual have been re-arranged. This guidance provides Manual users information on why we went to a web-based format, why the content was re-arranged, what the formatting style is, and most importantly, how to navigate the website.


Guidance - General Information

Navigating the website

Finding a topic

The left sidebar

Tables, images and downloadable files

This page was last edited on 19 July 2022, at 20:46.