Difference between revisions of "Help:Contents"

From MediaWiki
Jump to navigation Jump to search
m (→‎Content Suggestions: spelling and grammar cleanup)
 
(28 intermediate revisions by 4 users not shown)
Line 7: Line 7:
 
==[[#Content Suggestions|Content Suggestions]]==
 
==[[#Content Suggestions|Content Suggestions]]==
  
To make revisions to the content a User (must be registered) or can make a suggestion to the Content Manager for a particular Chapter:  
+
To make revisions to the content a User (must be registered) or can make a suggestion to the Content Manager for a particular Resource:  
  
The Content Managers for the various Chapters are:  
+
The Content Managers for the various Resources are:  
  
  
 
*'''Design Submittal Requirements''' - [mailto:MDOT-RIDSupport@michigan.gov MDOT RID Support]
 
*'''Design Submittal Requirements''' - [mailto:MDOT-RIDSupport@michigan.gov MDOT RID Support]
 +
*'''Survey Manual''' - [mailto:MDOT-Survey_Support@michigan.gov MDOT Survey Support]
  
  
 +
The Content Managers will then assign content suggestions to technical subject matter expert staff to discuss the merits of the suggested revision, make any supportive changes to the recommendation and update the content if deemed appropriate. User suggested changes are not scheduled to happen automatically; suggested changes will be vetted through appropriate review teams per the process appropriate for the type of change.
  
The Content Managers will then assign content suggestions to technical subject matter expert staff to discuss the merits of the suggested revision, make any supportive changes to the reccomendation and update the content if deemed appropriate. Just because a user suggests a change does not mean that it will happen automatically; it will be vetted throught appropriate review teams per the process appropriate for the type of change.
+
*'''Type 1:''' Editorial changes only, Content Manager can make the change without review from technical experts.
 
 
*'''Type 1:''' Editorial changes only, Content Manager can make the change without reveiw from technical experts.
 
 
*'''Type 2:''' Slight technical change or impacts more then one Chapter DG. This will be distributed by the Content Manager to an Ad Hoc team of technical area experts for review, discussion, approval and editing.  
 
*'''Type 2:''' Slight technical change or impacts more then one Chapter DG. This will be distributed by the Content Manager to an Ad Hoc team of technical area experts for review, discussion, approval and editing.  
*'''Type 3:''' Complex technical change, policy revision, or high cost. The Content Manager will assemlbe a team of technical area experts for reveiew, disscusion and drafting of a proposal to the Statewide Design Alignment Team (SDAT). Engineering Support Services will then make a decision, based on input from the SDAT, regarding implementation of the change in to the DG.  
+
*'''Type 3:''' Complex technical change, policy revision, or high cost. The Content Manager will assemble a team of technical area experts for review, discussion and drafting of a proposal to the Statewide Design Alignment Team (SDAT). Engineering Support Services will then make a decision, based on input from the SDAT, regarding implementation of the change in to the DG.  
 
Additional information regarding content revisions is located in the [[Content_Revision_Procedures|Content Revision Procedures]].
 
Additional information regarding content revisions is located in the [[Content_Revision_Procedures|Content Revision Procedures]].
 +
 +
{{top}}
  
 
==[[#Terms|Terms]]==
 
==[[#Terms|Terms]]==
Line 27: Line 29:
 
*'''May''' - Optional practice(s) with no requirement or recommendation.  
 
*'''May''' - Optional practice(s) with no requirement or recommendation.  
 
*'''Should''' - Expected or necessary. While not absolutely mandatory deviation from this practice calls for engineering documentation
 
*'''Should''' - Expected or necessary. While not absolutely mandatory deviation from this practice calls for engineering documentation
 +
 +
{{top}}
  
 
==[[#History|History]]==
 
==[[#History|History]]==
Would it be useful for you to be able to find when and how an article that you are interested in changed? Or view exactly what an article stated and how it looked in the past? Log into the DG and a “History” tab is available at the top of every article, providing a view of any previous versions of the DG article or comparing any two versions of the article on a line-by-line basis.  
+
Would it be useful for you to be able to find when and how an article that you are interested in changed? Or view exactly what an article stated and how it looked in the past? Log into the DG and a "History" tab is available at the top of every article, providing a view of any previous versions of the DG article or comparing any two versions of the article on a line-by-line basis.  
  
 
Many of the revisions will have a brief explanation. A bold "M" indicates a minor change (a Type 1 editorial change).
 
Many of the revisions will have a brief explanation. A bold "M" indicates a minor change (a Type 1 editorial change).
 +
 +
{{top}}
  
 
==[[#Watch/Watchlist|Watch/List]]==
 
==[[#Watch/Watchlist|Watch/List]]==
 
This is used to collect articles you are interested in to be able to view the changes to these articles.  
 
This is used to collect articles you are interested in to be able to view the changes to these articles.  
  
When you log into the DG a “watch” tab is located at the top of every article. Clicking the “watch” tab will add the article to your watch list. To remove it from the watch list click the same tab which is now labeled "unwatch".  
+
When you log into the DG a "watch" tab is located at the top of every article. Clicking the "watch" tab will add the article to your watch list. To remove it from the watch list click the same tab which is now labeled "unwatch".  
  
 
To view revisons to the watch list articles open up "my watch list" above the DG articles tab.  Choose the view changes that occured during a past time frame (2 hours, 6 hours, 3 days, etc.). A bold "M" identifies a minor change, new articles are identified with a bold "N". For significant revisions a descriptions of the revision is typically provided.
 
To view revisons to the watch list articles open up "my watch list" above the DG articles tab.  Choose the view changes that occured during a past time frame (2 hours, 6 hours, 3 days, etc.). A bold "M" identifies a minor change, new articles are identified with a bold "N". For significant revisions a descriptions of the revision is typically provided.
 +
 +
{{top}}
  
 
==[[#Preferences|Preferences]]==
 
==[[#Preferences|Preferences]]==
 
If you would like to have an email sent to you every time an article of interest in the DG has been changed this is where you'd select that option.  
 
If you would like to have an email sent to you every time an article of interest in the DG has been changed this is where you'd select that option.  
  
This email would not provide the details of the revision, but that the article was revised in some manner. Logging in to the DG will allow you to view the article’s history and to view the actual revision.  
+
This email would not provide the details of the revision, but that the article was revised in some manner. Logging in to the DG will allow you to view the article's history and to view the actual revision.
 +
 
 +
To obtain an email alert every time a DG article of interest has been revised, click "My Preferences", located above the DG article"s tabs. This leads to a "User Profile" tab. Near the bottom of the "User Profile" is the "e-mail" portion in which you may choose the various revision situations to send you an e-mail.
  
To obtain an email alert every time a DG article of interest has been revised, click “My Preferences”, located above the DG article’s tabs. This leads to a “User Profile” tab. Near the bottom of the “User Profile” is the “e-mail” portion in which you may choose the various revision situations to send you an e-mail.
+
{{top}}
  
 
==[[#Discussion|Discussion]]==
 
==[[#Discussion|Discussion]]==
Those logged into the DG are encouraged to use the discussion capability of the DG. If you have a question, it is likely others may, too. Any suggestions you have may also be very helpful to another reader, as well. Use the “Discussion” capabilities of the DG to contribute questions and suggestions for all other readers. The Engineering Support staff monitors all articles so that your comment can be addressed.  
+
Those logged into the DG are encouraged to use the discussion capability of the DG. If you have a question, it is likely others may, too. Any suggestions you have may also be very helpful to another reader, as well. Use the "Discussion" capabilities of the DG to contribute questions and suggestions for all other readers. The Engineering Support staff monitors all articles so that your comment can be addressed.
 +
 
 +
After logging in, simply go to the article of concern and select the "Discussion" tab at the top of the article. If your comment or question is the first discussion for the article, you will be shown an edit screen. Type in your comment or question. Otherwise, an existing discussion will be shown. Additional comments can be added by selecting the "+" tab.  
  
After logging in, simply go to the article of concern and select the “Discussion” tab at the top of the article. If your comment or question is the first discussion for the article, you will be shown an edit screen. Type in your comment or question. Otherwise, an existing discussion will be shown. Additional comments can be added by selecting the “+” tab.
+
{{top}}
  
 
==[[#Registering|Registering]]==
 
==[[#Registering|Registering]]==
Line 56: Line 68:
  
 
To become registered is as simple as creating a log in and verifying through the auto generated e-mail which you'll recieve.
 
To become registered is as simple as creating a log in and verifying through the auto generated e-mail which you'll recieve.
 +
 +
{{top}}
  
 
==[[#General Comments|General Comments]]==
 
==[[#General Comments|General Comments]]==
General comments or questions regarding the Development Guide Wiki should be sent to the e-mail address below.  
+
General comments or questions regarding the Development Guide should be sent to the appropriate e-mail address below.  
  
 
*'''[mailto:MDOT-RIDSupport@michigan.gov MDOT RID Support] '''
 
*'''[mailto:MDOT-RIDSupport@michigan.gov MDOT RID Support] '''
A Michigan Department of Transportation employee will then be able to assist you. Please note that this e-mail address is not for revising specific content but only for General Wiki questions or access concers (i.e. broken web links, wiki document downloads, etc.).
+
*'''[mailto:MDOT-Survey_Support@michigan.gov MDOT Survey Support]'''
 +
A Michigan Department of Transportation employee will then be able to assist you. Please note that this e-mail address is not for revising specific content but only for General questions or access concerns (i.e. broken web links, trouble with document downloads, etc.).
 +
 
 +
{{top}}
  
 
==[[#Support Resources|Support Resources]]==
 
==[[#Support Resources|Support Resources]]==
  
*'''[mailto:MDOT-RIDSupport@michigan.gov MDOT RID Support] '''
+
{| class="wikitable"
** Contact for questions related to 2D and 3D files posted to the RID folders.
+
|-
** This resource will also be responsible for providing comments as part of an independent review of the RID files.
+
! Support Resource!! Description
 
+
|-
*'''[mailto:MDOT-BridgeDesignSupport@michigan.gov MDOT Bridge Design Support] '''
+
| '''[mailto:MDOT-RIDSupport@Michigan.gov MDOT-RIDSupport@Michigan.gov] '''||Contact for help and support on the development and submittal requirements of Reference Information Documents (RID).
** Contact for questions related to Bridge Design.
+
This resource will also be responsible for providing comments as part of an independent review of the RID files.
 
+
|-
*'''[mailto:MDOT-CADDSupport@michigan.gov MDOT CADD Support] '''
+
| '''[mailto:MDOT-BridgeDesignSupport@Michigan.gov MDOT-BridgeDesignSupport@Michigan.gov] '''||Contact for questions related to Bridge Design cells, levels, and workspace tools.
** Contact for questions related to drawing tools and workspace installation.
+
|-
 
+
| '''[mailto:MDOT-CADDSupport@Michigan.gov MDOT-CADDSupport@Michigan.gov] '''||Contact for questions related to cells, levels, line styles, dimensions, and other CADD and workspace tools.
*'''[mailto:MDOT-PowerGEOPAKSupport@michigan.gov MDOT PowerGEOPAK Support] '''
+
|-
** Contact for questions related to geometry tools and roadway modeling
+
| '''[mailto:MDOT-RoadwayModelingSupport@Michigan.gov MDOT-RoadwayModelingSupport@Michigan.gov] '''||Contact for questions related to roadway modeling templates, civil cells, and workspace tools.
 
+
|-
*'''[mailto:MDOT-Drainage-Utility@michigan.gov MDOT Drainage-Utility Support] '''
+
| '''[mailto:MDOT-Drainage-Utility@Michigan.gov MDOT-Drainage-Utility@Michigan.gov] '''||Contact for questions related to GEOPAK drainage, drainage and utility cells, and other subsurface utility modeling tools.
** Contact for questions related to GEOPAK Drainage, and Subsurface Utilities.
+
|-
 
+
| '''[mailto:MDOT-Survey_Support@Michigan.gov MDOT-Survey_Support@Michigan.gov] '''||Contact for questions related to survey data, workflows, and processes.
*'''[mailto:MDOT-SupportServices@michigan.gov MDOT Support Services] '''
+
|-
** Contact for questions related to printing and software installation.
+
| '''[mailto:MDOT-Survey-Equipment-Support@Michigan.gov MDOT-Survey-Equipment-Support@Michigan.gov] '''||Contact for statewide support for survey field equipment including: training, troubleshooting, firmware updates and utilizing digital project data.
 
+
|-
*'''[mailto:MDOT-Survey_Support@michigan.gov MDOT Survey Support] '''
+
| '''[mailto:MDOT-Survey-Research-Request@Michigan.gov MDOT-Survey-Research-Request@Michigan.gov] '''||Contact for statewide support for survey research requests provided by Survey Support Services.
** Contact for questions related to Surveys.
+
|-
 +
| '''[mailto:MDOT-EngineeringSupportTraining@Michigan.gov MDOT-EngineeringSupportTraining@Michigan.gov] '''||Contact for training related to the software and tools supported by Engineering Support Services.
 +
|-
 +
!scope="row colspan=2 style="text-align:left;" |ProjectWise
 +
|-
 +
| '''[mailto:MDOT-ProjectWise@Michigan.gov MDOT ProjectWise] '''||General PW usage and issues (MDOT Staff only).
 +
|-
 +
| '''[mailto:MDOT-ePROPOSAL@Michigan.gov MDOT ePROPOSAL] '''||Letting process PW issues, including Proposals, Plans, RID, NTB and Addenda (MDOT Staff and External Partners).
 +
|-
 +
| '''[mailto:MDOT-ProjectWiseConsultant@Michigan.gov MDOT ProjectWiseConsultant] '''||Contact for help with anything related to ProjectWise logins, operations, workflows and tools for Design Consultants. (MDOT Staff and External Design Partners).
 +
|-
 +
| '''[mailto:MDOT-ProjectWiseCONST@Michigan.gov MDOT ProjectWiseCONST] '''||Contact for help with anything related to ProjectWise logins, operations, workflows and tools for Construction Contractors. (MDOT Staff and External Construction Partners).
 +
|-
 +
| '''[mailto:MDOT-ProjectWiseLocalAgency@Michigan.gov MDOT-ProjectWiseLocalAgency] '''||Contact for help with anything related to ProjectWise logins, operations, workflows and tools for Local Agencies. (MDOT Staff and External Design Partners).
 +
|}
 +
{{top}}

Latest revision as of 14:18, 7 May 2021

The Michigan Department of Transportation - Development Guide (DG) contains MDOT clarification on policy, procedure and guidance for the preparation of plans and 3D Models for road and bridge infrastructfure and other related facilities. The information is presented in numerous articles having as simple a layout as possible.

Organization

The Development Guide articles are grouped into chapters and sections similar to the Road Design Manual.

Content Suggestions

To make revisions to the content a User (must be registered) or can make a suggestion to the Content Manager for a particular Resource:

The Content Managers for the various Resources are:



The Content Managers will then assign content suggestions to technical subject matter expert staff to discuss the merits of the suggested revision, make any supportive changes to the recommendation and update the content if deemed appropriate. User suggested changes are not scheduled to happen automatically; suggested changes will be vetted through appropriate review teams per the process appropriate for the type of change.

  • Type 1: Editorial changes only, Content Manager can make the change without review from technical experts.
  • Type 2: Slight technical change or impacts more then one Chapter DG. This will be distributed by the Content Manager to an Ad Hoc team of technical area experts for review, discussion, approval and editing.
  • Type 3: Complex technical change, policy revision, or high cost. The Content Manager will assemble a team of technical area experts for review, discussion and drafting of a proposal to the Statewide Design Alignment Team (SDAT). Engineering Support Services will then make a decision, based on input from the SDAT, regarding implementation of the change in to the DG.

Additional information regarding content revisions is located in the Content Revision Procedures.

[top of page]


Terms

  • Shall - Mandatory practice, contract documents often contain independent definitions
  • May - Optional practice(s) with no requirement or recommendation.
  • Should - Expected or necessary. While not absolutely mandatory deviation from this practice calls for engineering documentation

[top of page]


History

Would it be useful for you to be able to find when and how an article that you are interested in changed? Or view exactly what an article stated and how it looked in the past? Log into the DG and a "History" tab is available at the top of every article, providing a view of any previous versions of the DG article or comparing any two versions of the article on a line-by-line basis.

Many of the revisions will have a brief explanation. A bold "M" indicates a minor change (a Type 1 editorial change).

[top of page]


Watch/List

This is used to collect articles you are interested in to be able to view the changes to these articles.

When you log into the DG a "watch" tab is located at the top of every article. Clicking the "watch" tab will add the article to your watch list. To remove it from the watch list click the same tab which is now labeled "unwatch".

To view revisons to the watch list articles open up "my watch list" above the DG articles tab. Choose the view changes that occured during a past time frame (2 hours, 6 hours, 3 days, etc.). A bold "M" identifies a minor change, new articles are identified with a bold "N". For significant revisions a descriptions of the revision is typically provided.

[top of page]


Preferences

If you would like to have an email sent to you every time an article of interest in the DG has been changed this is where you'd select that option.

This email would not provide the details of the revision, but that the article was revised in some manner. Logging in to the DG will allow you to view the article's history and to view the actual revision.

To obtain an email alert every time a DG article of interest has been revised, click "My Preferences", located above the DG article"s tabs. This leads to a "User Profile" tab. Near the bottom of the "User Profile" is the "e-mail" portion in which you may choose the various revision situations to send you an e-mail.

[top of page]


Discussion

Those logged into the DG are encouraged to use the discussion capability of the DG. If you have a question, it is likely others may, too. Any suggestions you have may also be very helpful to another reader, as well. Use the "Discussion" capabilities of the DG to contribute questions and suggestions for all other readers. The Engineering Support staff monitors all articles so that your comment can be addressed.

After logging in, simply go to the article of concern and select the "Discussion" tab at the top of the article. If your comment or question is the first discussion for the article, you will be shown an edit screen. Type in your comment or question. Otherwise, an existing discussion will be shown. Additional comments can be added by selecting the "+" tab.

[top of page]


Registering

There are benefits to becoming a registered user. This will allow you to create watchlists, get involved and start discussions and also allow you to make suggested changes to the DG at any time.

To become registered is as simple as creating a log in and verifying through the auto generated e-mail which you'll recieve.

[top of page]


General Comments

General comments or questions regarding the Development Guide should be sent to the appropriate e-mail address below.

A Michigan Department of Transportation employee will then be able to assist you. Please note that this e-mail address is not for revising specific content but only for General questions or access concerns (i.e. broken web links, trouble with document downloads, etc.).

[top of page]


Support Resources

Support Resource Description
MDOT-RIDSupport@Michigan.gov Contact for help and support on the development and submittal requirements of Reference Information Documents (RID).

This resource will also be responsible for providing comments as part of an independent review of the RID files.

MDOT-BridgeDesignSupport@Michigan.gov Contact for questions related to Bridge Design cells, levels, and workspace tools.
MDOT-CADDSupport@Michigan.gov Contact for questions related to cells, levels, line styles, dimensions, and other CADD and workspace tools.
MDOT-RoadwayModelingSupport@Michigan.gov Contact for questions related to roadway modeling templates, civil cells, and workspace tools.
MDOT-Drainage-Utility@Michigan.gov Contact for questions related to GEOPAK drainage, drainage and utility cells, and other subsurface utility modeling tools.
MDOT-Survey_Support@Michigan.gov Contact for questions related to survey data, workflows, and processes.
MDOT-Survey-Equipment-Support@Michigan.gov Contact for statewide support for survey field equipment including: training, troubleshooting, firmware updates and utilizing digital project data.
MDOT-Survey-Research-Request@Michigan.gov Contact for statewide support for survey research requests provided by Survey Support Services.
MDOT-EngineeringSupportTraining@Michigan.gov Contact for training related to the software and tools supported by Engineering Support Services.
ProjectWise
MDOT ProjectWise General PW usage and issues (MDOT Staff only).
MDOT ePROPOSAL Letting process PW issues, including Proposals, Plans, RID, NTB and Addenda (MDOT Staff and External Partners).
MDOT ProjectWiseConsultant Contact for help with anything related to ProjectWise logins, operations, workflows and tools for Design Consultants. (MDOT Staff and External Design Partners).
MDOT ProjectWiseCONST Contact for help with anything related to ProjectWise logins, operations, workflows and tools for Construction Contractors. (MDOT Staff and External Construction Partners).
MDOT-ProjectWiseLocalAgency Contact for help with anything related to ProjectWise logins, operations, workflows and tools for Local Agencies. (MDOT Staff and External Design Partners).

[top of page]