Documents: Difference between revisions

Revision as of 17:01, 21 June 2013

Document
A document is a written record related to an effort or topic

Last Ten Documents

Google scholar search

Wiki Rules

Wiki text does not reflect the policy or opinion of any agency or organization
Please adhere to our Social Contract and Style Guide
Complain here, and be nice.

Document pages describe published reports and articles. Pages either link to files uploaded on the wiki, to a off-site location, or to a Google Scholar search. Provided here are directions of creating a document page, and a list of all document pages.

Documents and the Social Contract

Uploading and providing analysis of documents should be consistent with our social contract. Don't violate copyright. Provide impersonal, evidence-driven analysis. Use concise language.

Standard Names for Document Pages

Every document has two pages. The page names are standardized so they are easy to find. THe main document page uses to following syntax:

Simenstad & Cordell 2000 salmonid habitat assessment pacific northwest

Odum 1988 tidal fresh vs salt marsh ecology

Gray et al 2002 salmon river habitat restoration performance

note that we start with an in-line citation format, and include just enough keywords in the title to guess at content and improve search functionality. There is also a redirect page that exists only to serve as a link to the main page. It uses an in-line citation format:

Simenstad & Cordell 2000

Odum 1988

Gray et al 2002

To create these two pages we recommend the following sequence:

Create the full document page but only using the short name.
Then Move the mage to a new location using its long name--the wiki will automatically create a redirect.

Creating a Document Page

There are two kinds of document pages. One is created automatically when you upload a file (the document itself) to the wiki--this is a special 'file page', and uses the 'File:' prefix in its page name. The other is just a standard wiki page.

Both document pages have the same content:

Document Template Code - Type the template code {{document}} at the top of text.
Categories - Pick some appropriate categories and add them to the top of text (examples are given in the edit page instructions).
Bibliographic Citation - Provide a bibliographic citation to help with searching and aid future users. We don't have a standard style--I tend to cut and paste from an available source.
Link to Document - If the document has a stable link location, than please provide it. Consider a google scholar search if you have any doubts about the stability of the document link.
Notes - This is where you put any comments or ideas provoked by the content or context of the document. While all edits are tracked, consider signing you note by adding "~~~" at the end, which will insert your user name so that a future reader may ask questions.

Creating a Google Scholar Search

If the document is under copyright, and cannot be uploaded, you can insert a google scholar link, like so:

[http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=0%2C48 Google Scholar Search for Simenstad & Cordell 2000]

Just go to google scholar, type in a competant search including authors date and keywords, and then paste search query from the address window and add the wiki markup and some link text. The example above produces the following results:

[http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=

Uploading a Document

The second way to create a document page is to actually upload a file to the wiki. This is a good choice if there is not currently a stable web location for the document, or it otherwise may become difficult to find. The content should be the same as for an off-wiki page. Follow the Upload a Document link found on any document page and follow instructions.

@@ Line 22: / Line 22: @@
 #Then [[Move]] the mage to a new location using its long name--the wiki will automatically create a [[redirect]].
-==Creating a Document Page for an Off-wiki Document==
+==Creating a Document Page==
-To create a document page, just type in a standard document name in the search window, and press [Go].  This will give you the option of creating the page.  Please include the following elements in a document page:
+There are two kinds of document pages.  One is created automatically when you upload a file (the document itself) to the wiki--this is a special 'file page', and uses the 'File:' prefix in its page name.  The other is just a standard wiki page.
-#'''Standard name''' - Use a standard document page name.
+Both document pages have the same content:
-#'''Document Template Code''' - Don't forget to put the [[template code]] <nowiki>{{document}}</nowiki> at the top of text.
-#'''Categories''' - Pick some appropriate [[categories]] and add them to the top of text (examples are given on the edit page).
+#'''Document Template Code''' - Type the [[template code]] <big><nowiki>{{document}}</nowiki></big> at the top of text.
-#'''Standard Bibliographic Citation''' - Please provide a text string that will lets a user cut and paste a standard bibliographic citation.
+#'''Categories''' - Pick some appropriate [[categories]] and add them to the top of text (examples are given in the edit page instructions).
+#'''Bibliographic Citation''' - Provide a bibliographic citation to help with searching and aid future users.  We don't have a standard style--I tend to cut and paste from an available source.
 #'''Link to Document''' - If the document has a stable link location, than please provide it.  Consider a google scholar search if you have any doubts about the stability of the document link.
+#'''Notes''' - This is where you put any comments or ideas provoked by the content or context of the document.  While all edits are tracked, consider signing you note by adding <big><nowiki>"~~~"</nowiki></big> at the end, which will insert your user name so that a future reader may ask questions.
-If you don't have time, at least do the first three steps and then flag it with the raw template code <nowiki>{{raw}}</nowiki>, indicating some sloppy work that needs fixing.
+===Creating a Google Scholar Search===
-==Creating a Google Scholar Search==
 If the document is under copyright, and cannot be uploaded, you can insert a google scholar link, like so:
@@ Line 40: / Line 40: @@
 Just go to [http://scholar.google.com/schhp?hl=en&as_sdt=0,48 google scholar], type in a competant search including authors date and keywords, and then paste search query from the address window and add the wiki markup and some link text.  The example above produces the following results:
-:'''[http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=0%2C48 Google Scholar Search for Simenstad & Cordell 2000]
+:'''[http://scholar.google.com/scholar?q=Simenstad+Cordell+2000+salmonid+habitat+assessment&btnG=&hl=en&as_sdt=
-==Notes==
-Please add a section to describe the value of the document.  Sign your remarks with three tildas, <nowiki>'''~~~'''</nowiki>.  This will create an author stamp with a link back to your user page.  Anyone can add to document analysis.
-==Uploading a Document==
+===Uploading a Document===
 The second way to create a document page is to actually upload a file to the wiki.  This is a good choice if there is not currently a stable web location for the document, or it otherwise may become difficult to find.  The content should be the same as for an off-wiki page.  Follow the [[special:upload|Upload a Document]] link found on any document page and follow instructions.
-==Creating a redirect page for easy citation==
-Documents have complicated page names like '''''File:Simenstad & Cordell 2000 criteria for restoring salmonid habitat'''''. To make it easy to cite, create a [[redirect]] page.  Create a page called '''''Simenstad & Cordell 2000''''', and on that page write a [[redirect]] that jumps the browser to the full document page.  In this way you can cite a document page by just typing the file name into your text like this:
- <nowiki>Salmon like to eat invertebrates ([[Simenstad & Cordell 2000]])</nowiki>
-Which will produce the following text:
-:'''Salmon like to eat invertebrates ([[Simenstad & Cordell 2000]]).'''
-[[redirect|Creating a redirect page]] is very easy.
 {|
 |style="width:50%;padding:0px 20px; vertical-align:top;"|