Difference between revisions of "Help:Analysis, Synthesis and Insight (ASI)"

From AquaPedia Case Study Database
Jump to: navigation, search
(created page)
 
Line 1: Line 1:
 +
{{Help}}
 
Analysis, Synthesis, and Insight sections (ASI) are special articles that are linked to each case study.
 
Analysis, Synthesis, and Insight sections (ASI) are special articles that are linked to each case study.
  
Line 7: Line 8:
 
==ASI Meta Information ==
 
==ASI Meta Information ==
  
Each ASI requests that the user provide information about contributors, the type of article being produced, and the viewpoint/experience of the contributor. This information is requested for better transparency and also to help readers understand the experience and viewpoints presented.
+
Each ASI requests that the user provide information about contributors, the type of article being produced, and the viewpoint/experience of the contributor. This information is requested for better transparency and also to help readers understand the experience and viewpoints presented.  
  
 
===Contributors===
 
===Contributors===
Line 24: Line 25:
 
===Title===
 
===Title===
 
Each ASI requires a unique title. While it will always be linked from the case, it may be found through other links. We suggest a descriptive title that briefly explains the "what and where" aspects of your contribution.
 
Each ASI requires a unique title. While it will always be linked from the case, it may be found through other links. We suggest a descriptive title that briefly explains the "what and where" aspects of your contribution.
 +
 +
===Article Content===
 +
Add your content here. You can add images and other supporting materials, but due to limitations of the Mediawiki Software, contributed images aren't protected the same way the rest of these articles are "locked down." We'd suggest you consider linking to any supporting materials that are located on other sites, if you are worried about the file being replaced by another user.
 +
  
 
===Summary===
 
===Summary===
 
You can provide a short summary that you would like to have appear when your ASI section is included on the Case Study page. You want this summary to be brief and express why a reader would want to view the full ASI contribution.
 
You can provide a short summary that you would like to have appear when your ASI section is included on the Case Study page. You want this summary to be brief and express why a reader would want to view the full ASI contribution.
 +
 +
=How Administrators edit these articles=
 +
Administrators will often edit these articles specifically for major grammatical issues, formatting concerns (e.g.: formatting references and links) and other minor changes that are largely cosmetic. These pages announce the name of the last user who edited the page, and the "History" tab will show you when and how the page was edited last. This is to maintain the largest amount of transparency possible.

Revision as of 12:28, 1 March 2013


Analysis, Synthesis, and Insight sections (ASI) are special articles that are linked to each case study.

These sections are in a special namespace, ASI, where documents can only be edited by the document creator and administrator-level accounts. While every other part of a case study can be edited by anyone with an account, ASI sections allow the original author to retain control over their contributions.

This allows for nuanced points of view, including multiple and conflicting viewpoints to be incorporated into a case study.

ASI Meta Information

Each ASI requests that the user provide information about contributors, the type of article being produced, and the viewpoint/experience of the contributor. This information is requested for better transparency and also to help readers understand the experience and viewpoints presented.

Contributors

In some instances, the user account contributing the ASI may be presenting information based upon multiple contributors work or on behalf of another person. This section allows the user to list a name and url for each contributor.

If you are the contributor, you may link the section to another website or your user page on AquaPedia. We'd recommend that you include a link only to a professional page that will persist for the foreseeable future.

Perspectives and Contribution Types'

You can indicate the perspective your contribution takes. You may provide multiple perspectives within a single contribution or separate your contributions into multiple ASIs for the same case.

Additionally, you should indicate the type of contribution: whether your article is providing strict analysis or a personal reflection on your experiences working within a case, or if this is a hybrid-type document.

Content

Title

Each ASI requires a unique title. While it will always be linked from the case, it may be found through other links. We suggest a descriptive title that briefly explains the "what and where" aspects of your contribution.

Article Content

Add your content here. You can add images and other supporting materials, but due to limitations of the Mediawiki Software, contributed images aren't protected the same way the rest of these articles are "locked down." We'd suggest you consider linking to any supporting materials that are located on other sites, if you are worried about the file being replaced by another user.


Summary

You can provide a short summary that you would like to have appear when your ASI section is included on the Case Study page. You want this summary to be brief and express why a reader would want to view the full ASI contribution.

How Administrators edit these articles

Administrators will often edit these articles specifically for major grammatical issues, formatting concerns (e.g.: formatting references and links) and other minor changes that are largely cosmetic. These pages announce the name of the last user who edited the page, and the "History" tab will show you when and how the page was edited last. This is to maintain the largest amount of transparency possible.